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ABSTRACT 

The  administration  of  all  automated  information  systems 
is  a  task  that  continues  to  become  increasingly  difficult  as 
the  numbers  and  complexity  of  these  systems  grow.  The 
Department  of  the  Navy  has  promulgated  regulations  dealing 
with  life  cycle  management  of  these  systems  from  the  mission 
analysis/project  initiation  phase  through  such  time  that  the 
system  is  terminated.  The  resources  required  to  perform 
this  managerial  control  are  no  longer  adequate  without  the 
assistance  of  automated  support. 

This  thesis  will  develop  a  micro-oriented  database 
management  system  that  will  enhance  and  simplify  management 
control  of  the  more  than  one  hundred  automated  systems 
currently  sponsored  by  the  Manpower  Systems  Integration 
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I.  INTRODUCTION 

A.   PURPOSE 

The  life  of  a  system  starts  with  the  identification  of  a 
deficiency  during  preliminary  mission  analysis.  Marine 
Corps  Order  P5231. 1  promulgates  instructions  regarding  the 
management  of  all  automated  systems  from  the  project  initia- 
tion phase,  through  such  time  as  that  system  is  replaced  or 
terminated.  Systems  analysts  produce  various  development 
item  documents,  including  a  mission  element  need  statement 
(MENS),  and  three  system  decision  papers,  prior  to  system 
approval  and  implementation.  Additional  configuration  item 
documentation,  such  as  system  and  program  specifications, 
users  manuals,  etc. ,  are  produced  and  maintained  after 
system  implementation. 

The  assignment  of  document  preparation  tasks,  and  the 
subsequent  retrieval  of  information  regarding  these  docu- 
ments, is  a  complex  and  tedious  process.  There  is  no 
central  repository  for  this  information.  The  manual  process 
of  retrieving  information  from  multiple  sources  is  time 
consuming  and  error  prone. 

The  Marine  Corps  Automated  Systems  Management 
Information  System  (MCASMIS)  is  an  integrated  systems  and 
project  management  tool.  It  was  designed  to  facilitate  the 
administration  of  all  automated  information  systems 
centrally  managed  at  the  Headquarters,  U.  S.  Marine  Corps 
level. 

The  Manpower  Systems  Integration  Branch,  Code  MPI-40  at 
Headquarters,  Marine  Corps,  will  be  the  primary  user  of  this 
system  for  systems  management.  The  Manpower  Information 
Systems  Liaison  Unit  (Code  MPI-70),  located  in  Kansas  City, 
Missouri,  will  be  co-users  of  the  project  management 
subsystem  together  with  Code  MPI-40.    A  system  manager  at 
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Headquarters,  Marine  Corps  will  perform  all  data  administra- 
tion aspects  of  this  system. 

MCASMIS  will  provide  an  automated  storage  and  retrieval 
system  for  all  systems  documentation,  while  tracking  the 
progress  of  systems  development  and  providing  information  on 
milestone  dates  by  means  of  exception  reports.  This  will 
replace  the  current  manual  mode  that  relies  primarily  on 
personal  notes  and  individual  memories. 

Various  projects  are  opened  for  particular  systems  both 
during  the  development  and  maintenance  portions  of  a  systems 
life  cycle.  MCASMIS  will  record  the  contents,  deliverables 
and  implementation  dates  of  these  projects  for  later 
retrieval  and  report  consolidation. 

B.  SCOPE 

The  MCASMIS  programs  were  obviously  tailored  to  this 
specific  Marine  Corps  environment.  Nevertheless,  they  may 
be  easily  modified  and  generalized  to  be  useful  for  any 
staff  involved  in  the  systems  management  arena. 

Because  of  the  unique  configuration  problems  associated 
with  the  distributed  processing  of  project  related  informa- 
tion at  both  Kansas  City  and  Washington,  D.  C.  ,  all  the 
security  features  provided  by  the  database  management  system 
could  not  be  fully  used.  These  problems  will  be  discussed 
in  more  depth  in  Chapter  3. 

The  administration  of  all  systems  and  projects  requires 
vast  financial  resources.  Unfortunately,  time  was  not 
sufficient  to  include  this  financial  aspect  within  the  scope 
of  this  paper.  It  is  a  suggested  area  for  future  versions 
of  this  prototype  system. 

C.  OUTLINE 

Chapter  two  provides  an  overview  of  the  operational 
environment.  It  discusses  peculiar  aspects  of  the  project 
management   tasks   and  delineates  how   these   tasks   are 
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currently  performed.    Finally,  it  outlines  how  MCASMIS  will 
alleviate  many  problems  with  the  current  methodology. 

Chapter  three  describes  the  database  management  software 
that  was  used  to  implement  MCASMIS.  It  provides  a  critique 
of  this  software  in  terms  of  capabilities  and  limitations. 
It  also  discusses  the  design  methodology  that  was  used  and 
briefly  summarizes  relative  strengths  and  weaknesses  of  the 
prototyping  technique. 

Chapter  four  contains  a  Bachman  diagram  showing  the 
relationships  of  the  tables  within  Mcasmis,  and  a  number  of 
structure  charts  depicting  the  hierarchy  of  the  programs. 

Chapter  five  recaps  the  initial  reaction  of  the  users  to 
the  first  version  of  the  prototype  system.  It  then  summa- 
rizes the  conclusions  for  the  project. 
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II.  NATURE  OF  THE  PROBLEM 

A.   OPERATIONAL  ENVIRONMENT 

The  Manpower  Systems  Integration  Branch,  Code  MPI-40,  is 
located  at  Headquarters,  U.  S.  Marine  Corps  in  Washington 
D.  C.  This  branch  centrally  manages  over  one  hundred  auto- 
mated information  systems.  All  proposed  manpower  related 
systems  are  staffed  through  this  office,  and  the  life  cycle 
documentation  for  these  systems  are  administered  and  filed 
here.  While  some  of  these  development  item  documents  are 
produced  within  the  Marine  Corps,  many  others  are  contracted 
out  to  private  industry.  Processing  sites  for  these  systems 
are  widely  distributed.  Most  of  the  Class  I  Marine  Corps 
systems  are  sponsored  at  one  of  three  large  data  processing 
installations  located  in  Kansas  City,  MO,  Albany,  GA,  and 
Quantico,  VA.  Additional  processing  sites  for  these  systems 
are  located  throughout  the  world. 

The  analysts  from  MPI-40  will  be  the  only  authorized 
users  to  modify  the  contents  of  the  systems  data  in  the 
MCASMIS  database.  Nevertheless,  all  systems  data  will  be 
available  for  retrieval  by  other  users  as  well.  MPI-40 
personnel  also  use  the  system  to  record  projects  that  were 
opened  by  them  for  each  of  the  systems.  Many  projects  are 
opened  for  work  by  civilian  contractors  outside  the 
Department  of  Defense.  Thus,  analysts  must  maintain  close 
coordination  with  multiple  development  activities  in  addi- 
tion to  the  activities  operated  and  managed  within  the 
Marine  Corps. 

The  Manpower  Information  Systems  Liaison  Unit  (Code 
MPI-70)  is  located  in  Kansas  City,  MO.  The  Central  Design 
and  Programming  Activity  (CDPA)  is  co-located  with  the 
Marine  Corps  Finance  Center  (MCFC)  in  Kansas  City  and  has 
primary   responsibility   for   all    automated   systems   that 
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administer  the  pay  and  personnel  records   of  active  duty, 
reserve  and  retired  Marines.   MPI-TO  is  the  primary  manpower 
functional  representative   for  the   following  systems  which 
are  processed  at  this  CDPA: 

•  JUMPS/MMS:    an   integrated   manpower  management   and 
financial  system  for  active  duty  Marines; 

•  REMMPS:    an   integrated  manpower  management   and  pay 
system  for  Marines  in  the  Reserve  establishment; 

•  ARMS:   an   automated  recruit   accession  and  management 
system;  and 

•  CPMS:    an  automated   career  planning   system  for   all 
Marines  throughout  the  world. 

MPI-70   personnel  will   use  MCASMIS   to   record  and  produce 

reports  on  all  projects  opened  for  these  systems.    Analysts 

will  also  analyze  production  problems  that  surface  in  any  of 

these  projects. 

B.   PROJECT  MANAGEMENT 

Analysts   open  projects   for  systems   both  during   the 
development  phase  and  after  the  system  has  been  implemented. 
Each  project  has   a  project  identification  number   issued  by 
MPI-40.    This  identifier  serves  as  the  key  for  all  informa- 
tion about  that  project  and  must  be  a  unique  value. 

1.  Projects  for  Systems  Under  Development 

Users  at  MPI-40  open  most  of  the  projects  for 
systems  under  development.  Private  industry  development 
activities  receive  contracts  to  complete  many  of  these 
projects.  Each  project  has  one  or  more  deliverables  associ- 
ated with  it.  Information  recorded  on  each  project  includes 
a  scheduled  due  date  for  that  deliverable.  Predefined 
queries  are  available  to  flag  those  projects  that  are 
overdue,  or  will  be  coming  due  soon.  MCASMIS  aids  manage- 
ment control  and  planning  from  a  centralized  perspective. 

2.  Projects  During  the  Maintenance  Phase 

Most  of  the  projects  are  opened  for  systems  that 
have  matured  beyond  the  development  phase.  After  systems 
have   been  implemented,    projects   that  modify  or   enhance 
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existing   logic   are   initiated   for  various   reasons.     A 
category  is   stipulated  for   each  project   at  the   time  that 
project  is  opened.    This  category  denotes  both  the  urgency 
of   the    requirement,    and   the   implementation   method. 
Categories  of  projects  opened  are: 

a.  Production  Modifications 

Production  Modifications  are  denoted  by  a  P  in 
the  category  field.  These  types  of  changes  are  normally  too 
urgent  to  wait  for  a  test  cycle  implementation.  For 
example,  erroneous  logic  that  prevents  a  Marine's  correct 
pay  computation,  or  errors  uncovered  in  the  fallout  of  a 
test  cycle  implementation.  This  is  the  most  dangerous  type 
of  modification  since  the  chances  of  compounding  the  error 
are  far  greater  than  under  circumstances  where  the  modifica- 
tion is  more  thoroughly  tested. 

b.  Test  Cycle  Modifications 

Test  Cycle  Modification  are  denoted  by  a  T  in 
the  category  field.  The  CDPA  implements  two  test  cycles  per 
year  for  the  major  systems  under  its  sponsorship.  All  large 
changes  that  have  no  over-riding  urgency  are  consolidated 
into  a  separate  version  of  application  programs.  Quality 
assurance  analysts  then  test  this  version  before  linking  it 
to  production.  Most  of  the  changes  implemented  at  the  CDPA 
fall  into  this  category.  This  is  the  safest  type  of  modifi- 
cation because  of  all  quality  assurance  and  change  control 
standards  are  enforced  before  linking.  Unfortunately,  this 
type  of  change  requires  a  long  lead  time  and  it  is  not 
always  feasible. 

c.  Stand  Alone  Modifications 

Stand  Alone  Modifications  are  denoted  by  an  S  in 
the  category  field.   Some  projects  are  too  complex  to  handle 
as  a  production  modification.   They  require  additional  safe- 
guards and  testing  before  they   can  be  linked  to  production. 
Nevertheless,  they  may  not  be  able  to  wait  for  the  next  test 
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cycle  implementation  for  various  reasons.  For  example,  a 
legislatively  imposed  entitlements  change,  a  GAO  audit 
requirement,  or  other  such  large  projects  that  have  a 
predetermined  deadline  may  fall  into  this  category.  These 
types  of  modifications  are  seldom  used  because  they  require 
analysts  and  programmers  to  maintain  another  version  of  all 
programs  in  addition  to  the  production  version  and  the  test 
cycle  version.  It  causes  real  nightmares  for  the  applica- 
tions programming  personnel  and  the  standards  personnel  who 
must  enforce  change  control. 
3.   Project  Priorities 

Project  information  is  input  by  MPI-VO  users  as  well 
as  users  at  MPI-40.  Users  assign  each  project  a  priority 
number.  This  enables  the  CDPA  or  other  development  activity 
to  allocate  the  proper  resources  depending  on  the  functional 
urgency.  MCASMIS  provides  a  multitude  of  management  reports 
that  enhance  the  control  of  these  projects  until  they  are 
completed. 

C.   STATUS  QUO 

With  the  minor  exception  of  a  few  standard  reports  that 
are  produced  by  word  processor,  virtually  all  management 
tasks  are  performed  manually  with  no  automated  support. 
Project  folders  are  started  for  each  project  and  system 
task.  These  folders  are  frequently  misplaced.  Much  of  the 
information  about  projects  and  systems  exist  only  in  the 
memories  of  the  major  participants  and  are  not  recorded. 
For  example,  participants  negotiate  agreements  at  project 
meetings,  and  fail  to  record  these  agreements  in  the  project 
folder.  Later  recollections  of  those  agreements  frequently 
differ  between  the  attending  parties.  More  importantly, 
possible  repercussions  of  project  implementation  fail  to 
sift  down  to  the  operational  level  when  these  side  effects 
are  discussed  at  upper  level  meetings.  Modifications  to  the 
original   request   are   seldom  documented   formally.     The 
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current  control  system  places  far  too  much  emphasis  on  the 
memories  of  the  respective  analysts. 

Typewritten  reports  concerning  the  status  of  various 
projects  for  the  systems  that  are  processed  are  produced 
periodically.  These  reports  are  then  mailed  to  Headquarters 
from  Kansas  City.  Ad  hoc  reports  are  time  intensive  and 
expensive  to  process.  There  is  no  central  repository  for 
all  pertinent  data.  Subsequently,  analysts  spend  many  hours 
researching  voluminous  paper  files  to  assimilate  the  answers 
to  these  requests. 

The  turnover  of  key  personnel  every  two  or  three  years 
further  exacerbates  the  problem.  This  turnover  completely 
strips  the  branch  of  invaluable  corporate  memory  that  is  not 
easily  recouped.  Responsible  parties  miss  milestones  not 
out  of  neglect,  but  out  of  ignorance  about  the  impending 
milestone  date. 

D.   PROPOSED  SYSTEM 

MCASMIS  seeks  to  automate  much  of  the  record  keeping  for 
all  systems,  development  activities  and  projects.  When  a 
system  development  task  is  undertaken,  all  milestone  dates 
are  planned  and  input.  MCASMIS  then  produces  standard 
reports  on  the  status  of  those  documents.  For  example, 
which  documents  have  not  been  tasked  to  anyone  yet?  Which 
milestones  are  coming  due  within  the  next  X  number  of  days? 
Which  development  activities  have  produced  this  type  of 
documentation  before?  By  entering  just  a  few  key  strokes, 
the  analyst  can  access  the  database  in  a  manner  such  that  a 
fast  and  accurate  response  to  almost  any  ad  hoc  request  is 
possible. 

Management  reports  produced  on  request  will  greatly 
enhance  the  administration  of  all  systems  under  the  cogni- 
zance of  the  branch.  Weak  or  potential  problem  areas  are 
rapidly  and  automatically  identified  to  permit  the  realloca- 
tion of  personnel  resources  to  effect  timely  resolution. 
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MPI-40  should  designate  a  systems  manager  to  oversee  the 
data  integrity  of  the  MCASMIS  database.  The  tasks  of 
archiving  records,  reloading  and  packing  the  database,  and 
unloading  records  to  permanent  history  files  on  magnetic 
diskettes  will  fall  under  the  purview  of  this  system 
manager. 
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III.  METHODOLOGY 

A.   GENERAL 

System  and  project  management  are  inter-related  func- 
tions. For  example,  projects  are  opened  only  for  predefined 
systems.  Deliverables  are  related  to  projects.  Financial 
obligations  are  incurred  for  projects  and  systems.  Database 
technology  allows  all  of  the  data  about  projects  and  systems 
to  be  processed  as  an  integrated  whole.  It  provides 
program/data  independence  which  permits  flexible  and 
powerful  ad  hoc  retrieval  that  is  not  easily  supported  by 
file  processing  systems.  Any  future  changes  to  the  struc- 
ture of  the  data  does  not  require  that  the  programs  which 
access  this  data  also  be  modified.  It  eliminates  data 
duplication.  For  example,  data  about  projects  need  not  be 
repeated  separately  in  project  and  system  application 
programs. 

Headquarters   selected  R: base   5000,   a   micro-oriented, 
relational  database  management  system,   systems  development. 
The  MCASMIS  system  was  developed  on  an  IBM  PC-XT,  and  should 
run  on  all  completely  compatible   equipment.    It  was  tested 
on  a   Zenith  Z-150  and   ran  satisfactorily  on   that  machine. 
MCASMIS  requires  a  hard  disk. 

1.   Capabilities  of  R: base 
a.   Programming  Language 

R: base  comes  with  a  programming  language  that  is 
well  documented  and  easy  to  learn.  All  structured 
constructs  are  supported  and  the  programs  are  easily  modu- 
larized to  produce  efficient,  robust  and  maintainable  code. 
Screen  design  is  facilitated  by  specific  commands  that 
generate  bordered  menus  and  on-line  help  screens.  R: base 
includes  a  menu-driven,  automatic  code  generator  which 
permits  flexible  data  retrieval  for  even  a  novice  user. 
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b.  Compiler 

A  built  in  compiler  converts  ASCII  application 
program  files  to  binary  representation.  This  not  only 
provides  additional  processing  speed,  but  helps  preserve  the 
integrity  of  the  programs.  The  user  can  neither  view,  nor 
modify,  this  source  code  with  text  editors. 

c.  Data  Dictionary 

A  passive  data  dictionary  provides  on-line  docu- 
mentation of  the  table  and  column  names  within  the  database. 
R: base  automatically  maintains  key  values,  and  verifies  the 
format  according  to  predefined  item  attributes.  For 
example,  types  defined  as  date,  dollar,  time  and  integer  are 
automatically  checked  for  proper  format  at  time  of  entry. 

d.  Automatic  Rule  Checking 

R:  base  permits  the  identification  of  rules  for 
data  entry.  Subsequent  attempts  to  load  or  modify  a  record 
that  violates  any  of  these  rules  are  automatically  rejected 
by  the  system.  This  feature  is  invaluable  in  preserving 
data  integrity  from  a  global  perspective.  It  eliminates  the 
requirement  to  code  for  this  editing  within  the  separate 
programs.  For  example,  a  rule  might  be  defined  which 
prohibits  opening  a  project  for  a  non-existent  system.  Any 
attempt  to  load  a  project  that  violates  this  rule  would  be 
rejected. 

2.   Limitations  of  R: base 
a.   Security 

R: base  permits  the  assignment  of  passwords  for 
writing  or  reading  data  from  individual  tables. 
Unfortunately,  these  passwords  can  only  be  defined  if  there 
is  an  owner  password  defined  for  the  entire  database. 
However,  when  an  owner  password  is  assigned,  only  that  user 
is  allowed  to  unload  data  from  the  database.  This  is  unac- 
ceptable in  the  current  situation.  Data  must  be  unloaded  at 
both  Kansas   City   and  Washington   to   keep   the   database 
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current.  Therefore,  MCASMIS  depends  on  manual  procedures  to 
preserve  the  data  security.  R:  base  does  not  provide  the 
flexibility  to  assist  in  this  unique  configuration 
environment. 

b.   Name  Scoping 

All  variables  defined  in  R: base  are  global.  The 
principle  of  information  hiding  is  violated  by  not  limiting 
the  visibility  of  the  variables  according  to  the  structure 
of  the  program  in  terms  of  subordinate  modules. 

Furthermore,    R: base   permits,    but   does   not 
require,   the  explicit  declaration   of  variables  before  use. 
A  stronger  typing  would  prevent   cumbersome  run  time  errors, 
and  would  enforce  traditionally  accepted  standards  of  struc- 
tured programming. 

B.   DESIGN  METHODOLOGY 

1.   Defining  Requirements 

Typically  the  hardest  task  associated  with  systems 
development  has  been  to   adequately  define  the  requirements. 
Table  I  depicts  the  series  of   tasks  performed  in  the  tradi- 
tional systems  development  process. 

TABLE  I 
TRADITIONAL  SYSTEMS  DEVELOPMENT  TASKS 

Feasibility  Study 

Requirements  Definition 

Preliminary  Design 

Detailed  Design 

Coding 

Integration 

Implementation 

Operations  and  Maintenance    -         ■ 

These  steps  normally  result  in  voluminous  documenta- 
tion that   is  rarely  understood  by   any  one   person  in   its 
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entirety.  It  is  also  a  lengthy  process  which  runs  the  risk 
of  users  changing  their  minds  before  completion.  Even  when 
the  users  are  involved  in  approving  the  results  of  each 
task,  the  outcome  cannot  be  assured.  Often,  the  users  feel 
coerced  into  signing  off  on  something  that  is  not  completely 
accurate,  or  even  understood.  Yet,  they  know  that  they  will 
not  get  to  see  anything  concrete  until  further  phases  have 
been  completed.  It  is  not  uncommon  for  the  users  to  react 
to  the  resultant  system  with  surprise  and  disdain.  One 
overheard  response  was,  "I  do  not  know  what  I  want,  but  I  do 
know  that  that's  not  it!"  Even  with  the  exceptionally 
computer  literate  users  of  MCASMIS,  the  traditional  approach 
to  systems  development  was  infeasible  for  this  project.  A 
two  day  visit  was  made  to  iyiPI-40  to  interview  the  analysts, 
obtain  insight  into  their  tasks  and  responsibilities,  and 
collect  sample  output  reports  that  would  be  desirable.  All 
personiiel  were  anxious  to  help  and  answered  all  questions. 
Nevertheless,  it  was  difficult  to  specifically  itemize  all 
requirements  of  the  proposed  system.  Tasks  were 
sufficiently  unstructured  to  preclude  exact  descriptions  of 
duties  and  unambiguous  user  specifications. 

It  was   therefore  decided   that  the   best  course   of 
action  would  be  to  build  a   functional  model  of   a  proposed 
system.    This  prototype  would  seek  to  alleviate  many  of  the 
present  problem  areas  in  the  systems  management  arena. 
2.   PrototypincT 

In  contrast  to  the  rigid,  disciplined  approach  to 
systems  development  using  the  structured  analysis  method- 
ology, prototyping  is  an  informal  procedure  that  results  in 
faster  convergence  between  need  and  specification. 
Specifications  are  refined  as  users  interact  with  the  proto- 
type system  and  the  analyst  who  developed  that  system.  Many 
experts  are  recognizing  the  advantages  of  such  a  methodology 
for  decision  support  systems.   As  described  in  [  Ref .  1], 


22 


A  structured  transaction-oriented  system  requires  an 
intensive  up-front  design  effort  to  get  firm  specifica- 
tions which  can  then  be  programmed.  A  decision  support 
system,  however,  involves  more  a  process  of  user 
learning.  An  appropriate  methodology  here  is  often  a 
crude  design  followed  by  a  simple  program.  Use  of  the 
programs  by  the  user  leads  to  successively  different  and 
more  comprehensive  design  as  its  performance  is  analyzed 
and  then  to  a  series  of  new  programs.  Interactively, 
one  cycles  through  this  sequence  a  number  of  times. 
Such  a  design  process  (pragmatically  useful)  flies  in 
the  face  of  generally  held  nostrums  about  good  develop- 
ment practices. 


The  geographic  separation  from  the  intended  users 
also  contributed  to  the  decision  to  use  the  prototyping 
approach.  Without  detailed  written  specifications,  this 
methodology  offered  the  highest  probability  of  ultimately 
satisfying  the  system  users. 

The  main  advantages  of  using  prototyping  are,  a 
better  understanding  of  user  requirements  through  faster 
feedback,  and  the  potential  for  using  the  prototype  as  the 
final  solution  [ Ref .  2].  It  is  this  second  advantage  that 
also  contributes  to  a  serious  pitfall  of  this  methodology. 
If  the  prototype  is  accepted  as  the  final  solution,  there  is 
danger  of  incorporating  logical  errors  that  will  render 
subsequent  enhancement  unattainable.  A  prototypic  design  is 
almost  purely  physical  in  nature.  An  unambiguous  statement 
of  specifications  from  a  logical  perspective  would  preclude 
such  errors  from  being  perpetuated  in  the  maintenance  phase. 
Fortunately,  R: base  provides  a  flexible  array  of  data  manip- 
ulation functions  that  should  accommodate  any  necessary 
schema  modifications  should  a  logical  error  surface.  Of 
course,  this  capability  is  not  unique  to  R: base.  It  is  an 
inherent  advantage  of  all  relational  data  base  management 
systems  which  provide  program/data  independence. 
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IV.  MCASMIS  DESIGN 

A.  DATABASE  DESIGN 

Table  II  depicts  the  logical  relationships  of  the 
primary  tables  in  the  MCASMIS  database.  Also  included  in 
this  database  are  copies  of  the  system,  project,  TTC  and 
deliver  tables  that  are  used  for  temporary  storage  of 
archived  records.  The  number  of  arrows  shown  for  each  table 
on  this  Bachman  Diagram  denote  either  a  one  to  many  or  a 
many  to  many  relationship.  For  example,  each  project  could 
have  many  deliverables,  but  every  deliverable  is  associated 
with  only  one  project.  Conversely,  each  project  could 
effect  multiple  TTCs,  and  each  TTC  could  be  related  to  many 
projects. 

The  relationships  between  the  files  are  connected  by  key 
fields  which  must  be  defined  as  unique  values.  The  MPI-ID 
serves  as  the  key  which  establishes  the  relationship  between 
project,  TTC  and  deliverable  records.  The  SYSNAME  is  the 
key  value  for  system  and  doclist  records,  and  DEVACT  is  the 
key  for  vendor  records. 

B.  PROGRAM  DESIGN 

Tables  III  through  IX  show  the  hierarchical  structure  of 
the  application  programs  that  comprise  MCASMIS.  The  system 
was  designed  to  be  completely  user  friendly.  On-line  help 
is  available  at  any  of  the  menu  screens  by  pressing  FIG. 
MCASMIS  also  provides  an  emergency  escape  mechanism  to 
return  directly  to  the  main  menu  from  any  of  the  subordinate 
modules. 

Table  III  depicts  the  main  level  of  the  program  as  well 
as  the  modules  that  comprise  the  database  management  aspects 
of  MCASMIS. 
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Table  IV  shows  the  standard  add,  change  and  delete  func- 
tions for  systems  management.  Tables  V  and  VI  display  the 
hierarchy  for  the  systems  management  query  and  management 
reports  options  respectively.  Queries  are  normally  one  of  a 
kind,  ad  hoc  requests  that  may  be  used  to  answer  many  ques- 
tions that  arise  in  the  course  of  systems  administration. 
Management  reports  are  usually  more  structured,  recurring 
data  retrievals  that  provide  management  control  and  assist 
in  the  planning  of  resource  allocation. 

Tables  VII  through  IX  depict  the  same  respective  func- 
tions for  the  project  management  subsystem.  Appendix  C 
contains  detailed  instructions  on  the  use  and  purpose  of  all 
the  above  programs. 
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TABLE   V 
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TABLE  VI 
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TABLE  VII 
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TABLE   VIII 
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TABLE    IX 
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V.  CONCLUSIONS 

A.  INITIAL  REACTIONS 

It  required  approximately  three  months  to  develop  the 
original  version  of  the  prototype  system.  A  meeting  to 
demonstrate  this  model  was  arranged  in  Kansas  City.  The 
user  operated  the  system  with  virtually  no  assistance.  The 
prototype  proved  to  be  user  friendly  and  robust.  This 
review  uncovered  a  few  human  interface  problems  which  were 
trivial  to  modify.  Examples  of  some  of  the  problems  uncov- 
ered were: 

•  Providing  advisory  messages  to  the  user  that  the  appli- 
cation was  working  during  lengthy  retrievals; 

•  A  less  disruptive  method  for  routing  desired  output  to 
the  printer  as  well  as  to  the  screen; 

•  A  different  sort  criterion  for  one  of  the  management 
reports;  and 

•  Provide  the  option  of  listing  valid  arguments  at  some 
of  the  system  prompts  when  the  user  is  unsure  of  the 
input. 

Some  of  the  programs  were   also  broken  down  into  smaller 

modules.    This   noticeably  increased  the   responsiveness  of 

the  system. 

B.  SUMMARY 

This  thesis  does  not  purport  to  recommend  prototyping  as 
an  alternative  to  the  rigorous,  time-intensive  structured 
systems  development  techniques.  Nevertheless,  prototyping 
did  enable  the  production  of  a  functional  decision  support 
system  that  could  serve  as  the  framework  for  a  detailed  set 
of  user  requirements.  It  could  be  used  in  its  present  form 
immediately.  Feedback  provided  by  the  users  will  serve  as 
an  excellent  and  credible  definition  of  requirements  for 
system  refinements.  It  is  beyond  the  scope  of  this  thesis 
to  analyze  the  relative  advantages  and  disadvantages  of 
prototyping  in  general.   Prototyping  as  a  design  methodology 
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has  proved  to  be  exceptionally  effective  in  this  particular 
development  effort. 

Future  enhancements  to  MCASMIS  should  include  the  incor- 
poration of  financial  resource  data  that  are  connected  to 
each  system  and  project,  and  more  stringent  data  security 
regarding  both  passwords  and  procedures.  The  multi-user 
version  of  R: base  may  offer  some  assistance  in  this  area. 
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APPENDIX  B 
DATA  DICTIONARY 

A.   TABLES  IN  THE  DATABASE 

Table:  REPORTS 
Read  Password:  NO 
Modify  Password:  NO 

Column  definitions 

#  Name     Type  Length         Key 

1  RNAME     TEXT  8  characters  yes 

2  RDATA    TEXT  132  characters 

Current  number  of  rows:      93 


Table:  DOCUMENT 
Read  Password:  NO 
Modify  Password:  NO 

Column  definitions 

#  Name     Type  Length         Key 

1  DOCABR    TEXT       13  characters 

2  DOCTITLE  TEXT      45  characters 

3  DOCREF    TEXT       12  characters 

4  LIFECAT   TEXT        2  characters 

Current  number  of  rows:      33 


Table:  DOCLIST 
Read  Password:  NO 
Modify  Password:  NO 

Column  definitions 


# 

Name 

Type 
TEXT 

Length 

Key 

1 

SYSNAME 

11  characters 

yes 

2 

DOCABR 

TEXT 

13  characters 

3 

DOCNAME 

TEXT 

109  characters 

4 

DEVACT 

TEXT 

16  characters 

5 

DOCDATE 

DATE 

1  value(  s ) 

6 

DSTAT 

TEXT 

1  characters 

• 

Current  number  of  rows:     234 


Table:  SYSTEM 
Read  Password:  NO 
Modify  Password:  NO 

Column  definitions 

#  Name     Type  Length         Key 

1  SYSNAME   TEXT  11  characters  yes 

2  LNGTITLE  TEXT  72  characters 

3  CATEGORY  TEXT  3  characters 

4  ANALYST   TEXT  10  characters 

5  MENS      DATE  1  value(s) 

6  SDPI      DATE  1  value(s) 

7  SDPI I     DATE  1  value(s) 
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8 

SDPIII 

DATE 

1 

value(  s) 

9 

EXP LIFE 

TEXT 

3 

characters 

10 

PRIUSER 

TEXT 

9 

characters 

11 

ENV 

TEXT 

10 

characters 

12 

CLASS 

TEXT 

2 

characters 

13 

COMPLANG 

TEXT 

10 

characters 

14 

PGMS 

INTEGER 

1 

value( si 

15 

LOG 

INTEGER 

1 

value( s 

16 

IMPDATE 

DATE 

1 

value( s 

17 

AMENS 

DATE 

1 

value( s 

18 

ASDPI 

DATE 

1 

value( s 

19 

ASDPII 

DATE 

1 

value( s 

20 

ASDPI I I 

DATE 

1 

value( s 

Current  number  of  rows: 
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Table:  VENDOR 
Read  Password:  NO 
Modify  Password:  NO 


Column  def 

initions 

# 

Name 

Type 
TEXT 

1 

DEVACT 

2 

DEVLONG 

TEXT 

3 

CONTACT 

TEXT 

4 

PHONE 

TEXT 

5 

ADDRESS 

TEXT 

6 

CITY 

TEXT 

7 

STATE 

TEXT 

8 

ZIPCODE 

TEXT 

Length  Key 
16  characters  yes 
54  characters 
20  characters 
13  characters 
20  characters 
15  characters 
2  characters 
5  characters 


Current  number  of  rows: 


39 


Table:  FORMS 
Read  Password:  NO 
Modify  Password:  NO 

Column  definitions 
#  Name      Type 

1  FNAME     TEXT 

2  FDATA     TEXT 


Length         Key 
8  characters  yes 
80  characters 


Current  number  of  rows: 


161 


Table:  RULES 
Read  Password:  NO 
Modify  Password:  NO 

Column  definitions 


# 

Name 

I^?EGER 

1 

NUMRULE 

2 

AND/OR 
COLNAMEl 

TEXT 

3 

TEXT 

4 

TABLE 1 

TEXT 

5 

BOOLEAN 

TEXT 

6 

C0LNAME2 

TEXT 

7 

TABLE2 

TEXT 

8  RULVALUE  TEXT 


Length 

1  value(  s) 
4  characters 
8  characters 
8  characters 
4  characters 
8  characters 
8  characters 
40  characters 


Key 


i 


Current  number  of  rows: 


52 


Table:  PROJECT 
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Read  Password:  NO 
Modify  Password:  NO 


Column  defi 

# 

Name 

1 

MP I -ID 

2 

ACTIV-ID 

3 

PRO J- ID 

4 

SYSNAME 

5 

CAT 

6 

PRIORITY 

7 

FUNCPO 

8 

ACTIVPO 

9 

STATUS 

10 

DEVACT 

11 

PROJNAME 

12 

STRUCW/T 

13 

DATEREQ 

14 

REODUE 

15 

SCfiEDDUE 

16 

COMPLETE 

17 

TESTCOND 

18 

TESTED 

nitions 

^XPS 

Length 

TEXT 

10 

char, 

TEXT 

10 

char 

TEXT 

3 

char 

TEXT 

11 

char 

TEXT 

1 

char 

INTEGER 

1 

valui 

TEXT 

15 

char 

TEXT 

15 

char 

TEXT 

1 

char 

TEXT 

16 

char 

TEXT 

79 

char 

DATE 

1 

valu 

DATE 

1 

valu 

DATE 

1 

valu 

DATE 

1 

valu 

DATE 

1- 

valu 

INTEGER 

1 

valu 

INTEGER 

1 

valu 

Current  number  of  rows: 


Key 
acters  yes 
acters 
acters 
acters 
acters 
e(s) 
acters 
acters 
acters 
acters 
acters 
e(  s 
e(  s 
e(  s 
e(  s 
e(  s 
e(  s 
e(  s 
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Table:  TTC 

Read  Password:  NO 

Modify  Password:  NO 

Column  definitions 
#  Name     Type 

1  MP I -ID    TEXT 

2  TTC       TEXT 


Length         Key 
10  characters 
3  characters 


Current  number  of  rows: 


12 


Table:  DELIVER 
Read  Password:  NO 
Modify  Password:  NO 

Column  definitions 
#  Name      Type 

1  MP I -ID    TEXT 

2  DELIVER   TEXT 


Length  Key 

10  characters 
79  characters 


Current  number  of  rows: 


20 


Table:  DOCHIST 
Read  Password:  NO 
Modify  Password:  NO 

Column  definitions 


# 

Name 

Type 
TEXT 

Length 

1 

SYSNAME 

11  characters 

2 

DOCABR 

TEXT 

13  characters 

3 

DOCNAME 

TEXT 

109  characters 

4 

DEVACT 

TEXT 

16  characters 

5 

DOCDATE 

DATE 

1  value( s ) 

6 

DSTAT 

TEXT 

1  characters 

Key 


Current  number  of  rows: 
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Table:  PROJHIST 
Read  Password:  NO 
Modify  Password:  NO 


Column  defi 

# 

Name 

1 

MPI-ID 

2 

ACTIV-ID 

3 

PRO J- ID 

4 

SYSNAME 

5 

CAT 

6 

PRIORITY 

7 

FUNCPO 

8 

ACTIVPO 

9 

STATUS 

10 

DEVACT 

11 

PROJNAME 

12 

STRUCW/T 

13 

DATEREQ 

14 

REODUE 

15 

SCHEDDUE 

16 

COMPLETE 

17 

TESTCOND 

18 

TESTED 

nitions 

Type 
TEXT 

Length 
10  characters 

TEXT 

10 

characters 

TEXT 

3 

characters 

TEXT 

11 

characters 

TEXT 

1 

characters 

INTEGER 

1 

value(  s) 

TEXT 

15 

characters 

TEXT 

15 

characters 

TEXT 

1 

characters 

TEXT 

16 

characters 

TEXT 

79 

characters 

DATE 

1 

value< 

:  s 

DATE 

1 

value! 

s 

DATE 

1 

value! 

s 

DATE 

1 

value! 

s 

DATE 

1 

value! 

s 

INTEGER 

1 

value! 

s 

INTEGER 

1 

value! 

,  s ' 

Key 


Current  number  of  rows: 


0 


Table:  TTCHIST 
Read  Password:  NO 
Modify  Password:  NO 

Column  definitions 
#  Name      Type 

1  MPI-ID    TEXT 

2  TTC       TEXT 


Length         Key 
10  characters 
3  characters 


Current  number  of  rows: 


0 


Table:  DLVRHIST 
Read  Password:  NO 
Modify  Password:  NO 

Column  definitions 
#  Name      '^XP? 


1  MPI-ID 

2  DELIVER 


TEXT 
TEXT 


Length 
10  characters 
79  characters 


Key 


Current  number  of  rows: 


0 


B.   COLUMNS  IN  ALPHABETICAL  ORDER 

Column  definitions 

Name     Type     Length         Table     Key 
ACTIV-ID  TEXT      10  characters  PROJECT 

PROJHIST 
ACTIVPO   TEXT       15  characters  PROJHIST 

PROJECT 
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ADDRESS 

TEXT 

20 

characters 

VENDOR 

AMENS 

DATE 

1 

value(  s) 

SYSTEM 

ANALYST 

TEXT 

10 

characters 

SYSTEM 

AND/OR 

TEXT 

4 

characters 

RULES 

ASDPI 

DATE 

1 

value( s) 

SYSTEM 

ASDPII 

DATE 

1 

value( s) 

SYSTEM 

ASDPI I I 

DATE 

1 

value( s) 

SYSTEM 

BOOLEAN 

TEXT 

4 

characters 

RULES 

CAT 

TEXT 

1 

characters 

PROJECT 
PROJHIST 

CATEGORY 

TEXT 

3 

characters 

SYSTEM 

CITY 

TEXT 

15 

characters 

VENDOR 

CLASS 

TEXT 

2 

characters 

SYSTEM 

COLNAMEl 

TEXT 

8 

characters 

RULES 

C0LNAME2 

TEXT 

8 

characters 

RULES 

COMPLANG 

TEXT 

10 

characters 

SYSTEM 

COMPLETE 

DATE 

1 

value(  s) 

PROJHIST 
PROJECT 

CONTACT 

TEXT 

20 

characters 

VENDOR 

DATEREQ 

DATE 

1 

value(  s) 

PROJHIST 
PROJECT 

DELIVER 

TEXT 

79 

characters 

DELIVER 
DLVRHIST 

DEVACT 

TEXT 

16 

characters 

DOCLIST 

VENDOR 

PROJECT 

PROJHIST 

DOCHIST 

DEVLONG 

TEXT 

54 

characters 

VENDOR 

DOCABR 

TEXT 

13 

characters 

DOCHIST 
DOCLIST 
DOCUMENT 

DOCDATE 

DATE 

1 

value( s) 

DOCHIST 
DOCLIST 

DOCNAME 

TEXT 

109 

characters 

DOCLIST 

yes 
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DOCHIST 

DOCREF 

TEXT 

12 

characters 

DOCUMENT 

DOCTITLE 

TEXT 

45 

characters 

DOCUMENT 

DSTAT 

TEXT 

1 

characters 

DOCHIST 
DOCLIST 

ENV 

TEXT 

10 

characters 

SYSTEM 

EXP LIFE 

TEXT 

3 

characters 

SYSTEM 

FDATA 

TEXT 

80 

characters 

FORMS 

FNAME 

TEXT 

8 

characters 

FORMS      yes 

FUNCPO 

TEXT 

15 

characters 

PROJHIST 
PROJECT 

IMPDATE 

DATE 

1 

value( s) 

SYSTEM 

LIFECAT 

TEXT 

2 

characters 

. DOCUMENT 

LNGTITLE 

TEXT 

72 

characters 

SYSTEM 

LOC 

INTEGER 

1 

value( s) 

SYSTEM 

MENS 

DATE 

1 

value( s) 

SYSTEM 

MP I -ID 

TEXT 

10 

characters 

DELIVER 

DLVRHIST 

PROJHIST 

TTC 

PROJECT    yes 

TTCHIST 

NUMRULE 

INTEGER 

1 

value( s) 

RULES 

POMS 

INTEGER 

1 

value(  s) 

SYSTEM 

PHONE 

TEXT 

13 

characters 

VENDOR 

PRIORITY 

INTEGER 

1 

value( s) 

PROJECT 
PROJHIST 

PRIUSER 

TEXT 

9 

characters 

SYSTEM 

PROJ-ID 

TEXT 

3 

characters 

PROJECT 
PROJHIST 

PROJNAME 

TEXT 

79 

characters 

PROJECT 
PROJHIST 

RDATA 

TEXT 

132 

characters 

REPORTS 

REQDUE 

DATE 

1 

value( s) 

PROJHIST 
PROJECT 
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RNAME 

TEXT 

RULVALUE 

TEXT 

SCHEDDUE 

DATE 

SDPI 

DATE 

SDPII 

DATE 

SDPI I I 

DATE 

STATE 

TEXT 

STATUS 

TEXT 

STRUCW/T  DATE 


SYSNAME   TEXT 


8 

characters 

REPORTS 

yes 

40 

characters 

RULES 

1 

value(  s) 

PROJHIST 
PROJECT 

1 

value( s) 

SYSTEM 

1 

value( s) 

SYSTEM 

1 

value( s) 

SYSTEM 

2 

characters 

VENDOR 

1 

characters 

PROJECT 
PROJHIST 

1 

value(  s) 

PROJECT 
PROJHIST 

11 

characters 

DOCLIST 

yes 

SYSTEM 

yes 

PROJECT 

PROJHIST 

DOCHIST 

8 

characters 

RULES 

8 

characters 

RULES 

1 

value(  s) 

PROJHIST 
PROJECT 

1 

value(  s) 

PROJECT 

1 

value(  s) 

PROJHIST 

3 

characters 

TTC 
TTCHIST 

5 

characters 

VENDOR 

TABLE 1  TEXT 
TABLE2  TEXT 
TESTCOND  INTEGER 

TESTED  INTEGER 
TESTED  INTEGER 
TTC       TEXT 

ZIPCODE   TEXT 

C.   COLUMN  DESCRIPTIONS 

ACTIV-ID  The  internal   document  control  number  used   ny  each 

activity  to  identify  a   given  project  originated  by 

an  MP I -ID. 
ACTIVPO   The   name   of   the  activity  project   officer  with 

primary  responsibility  for  this  project. 
ADDRESS   The  mailing  address  of  the  development  activity. 
AMENS    The  ACTUAL  date  the  MENS  was  completed. 
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ANALYST   The   name    of   the   MP I -40    analyst   who   has 

responsiblity  for  this  system. 
AND/OR   An  R: base  column  name   used   for  data   edit/entry 

checking  in  conjunction  with  the  RULES  function. 
ASDPI     The  ACTUAL  date  that  the   System  Decision  Paper  One 

was  completed. 
ASDPI I    The  ACTUAL  date  that  the   System  Decision  Paper  Two 

was  completed. 
ASDPI I I   The   ACTUAL  date   that   the   System  Decision  Paper 

Three  was  completed. 
BOOLEAN  Used  by   the   R: base   RULES   function    for   data 

editing/entering. 
CAT      The  project  category  which  may  be  (P) reduction  mod^ 

(T)est  cycle,  or  ( S) tandalone. 
CATEGORY  An   abbreviation  denoting  whether   the   system   is 

Marine   Corps    or  DOD/DON    and  whether    it   is 

operational  or  being  developed. 
CITY     The   city   in  which  the   development   activity   is 

located. 
CLASS    The  class   designation  of   the  system   according  to 

MCO  P5231. 1. 
COLNAMEl  Used  by   the   R: base   RULES   function    for   data 

editing/entering. 
C0LNAME2  Used  by   the   R: base   Rules   function    for   data 

editing/entering. 
COMPLANG  The  programming  language( s)   in  which  the  system  is 

written, 
COMPLETE  The  date  that  the  project  was  completed.    As  such, 

this  date  also  indicates  the   date  that  the  project 

was  closed. 
CONTACT   Point  of  contact  in  that  development  activity. 
DATEREQ   The  date   of  the   MP I  request   that  originated   the 

project. 
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DELIVER  The  deliverable( s)    contracted  to  be  received   in 

conjunction  with  a  given  project, 
DEVACT   The  development  activity  abbreviation. 
DEVLONG   The  long  title  of  the  development  activity. 
DOCABR   The  document(s)   abbreviation.    Multiple  documents 

are  indicated  by  a   slash  between  the  abbreviations 

(e.g.  UM/MM/OM). 
DOCDATE  The  date  of  the  life  cycle  document. 
DOCNAME   The  title  of  the  life  cycle  document. 
DOCREF   The  reference  for  the  life  cycle  document. 
DOCTITLE  The   long  title   of  the   life   cycle  document   type 

(e.g.   RS  =  Requirements  Statement), 
DSTAT    The-  status  indicator   of   the  document   indicating 

whether  the  document  is  completed  or  pending. 
ENV      The  environment  in  which  the  system  processes. 
EXPLIFE  The  expected  life  of  the  automated  system. 
FDATA    Used  by  the   R: base  FORMS  function  in  defining  the 

formatted  forms  for  data  entry  and  editing. 
FNAME    Used  by  the   R: base  FORMS  function  in  defining  the 

formatted  forms  for  data  entry  and  editing. 
FUNCPO    The  functional   analyst  assigned   as  the   cognizant 

officer  for  the  project. 
IMPDATE   The  date  that  the  system  was  implemented. 
LIFECAT   Indicates  whether  the  life  cycle  document  type  is  a 

development  item  or  a  configuration  item. 
LNGTITLE  The  long  title  of  the  system. 
LOG      The  number   of  thousands   of  lines   of  code   in  the 

system. 
MENS      The  SCHEDULED  due  date  for  the  MENS  document. 
MPI-ID    The  control  number  of  the   MPI  source  document  that 

originated  a  project.     This  is  the  key   field  for 

all  projects. 
NUMRULE   Used  by   the   R: base   RULES   function    for   data 

editing/entering. 
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PROJ-ID   The    alphanumeric   identifier    assigned   at    the 

installation  to  which  the  project   request  was 

forwarded. 
PGMS     The  number   of  computer  programs  that   comprise  the 

system. 
PHONE    The  phone  number  of  the  development  activity. 
PRIORITY  The  priority  assigned  by  the  functional  manager  for 

that  project 
PRIUSER  The  primary  user  of  the  system. 

PROJNAME  A  short  description  of  the  purpose  of  the  project. 
RDATA    Used  by  the  R: base  REPORTS  function. 
REQDUE   The   requested  due   date  specified   in  the   project 

request. 
RNAME     Used  by  the  R: base  REPORTS  function. 
RULVALUE  Used  by  the  R: base  REPORTS  function. 
SCHEDDUE  The   scheduled  due   date  as   negotiated  with   the 

development  activity. 
SDPI      The  SCHEDULED  due  date  of  the  System  Decision  Paper 

One. 
SDPI I     The  SCHEDULED  due  date  of  the  System  Decision  Paper 

Two. 
SDPI I I    The  SCHEDULED  due  date  of  the  System  Decision  Paper 

Three. 
SORTNBR   Used  by   the  R:  base  REPORTS   function  to   print  the 

systems  properly  sorted  by  category. 
STATE    The   state  in  which   the   development  activity   is 

located. 
STATUS    The  status  of  the  project  which  is  either  (O)pen  or 

( C)losed. 
STRUCW/T  The   date   that   the  structured   walk   through   was 

conducted  by  the  MPI  functional  analysts. 
SYSNAME   The  system  name  abbreviation. 
TABLEl    Used  by    the   R: base   RULES   function    for   data 

editing/entering. 
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TABLE2    Used  by   the   R: base   RULES   function    for   data 

editing/entering. 
TESTCOND  The  total  number  of   test  conditions  identified  for 

satisfactory  testing  of  the  project. 
TESTED   The  number  of  test  conditions  tested  to  date. 
TTC      The  type   transaction  code  which  must  be  modified, 

deleted  or  created  by  the  project. 
ZIPCODE   The  zip  code  of  the  development  activity. 

D.   ERROR  MESSAGES 

DOl-THIS  SYSTEM  IS  NOT  ON  FILE 

Probable  Cause:   You  tried  to  add  or  change  a  document 

specifying  a  system  name  that  does  not  exist 

in  the  database. 
Corrective  Action:     You  must   first  add   this  system 

name  using  option  1  of  the  Systems  Add  Menu. 

D02-DOC  ABBREVIATION  IS  A  MANDATORY  FIELD 

Probable  Cause:   You  tried  to  add  or  change  a  document 

without  specifying  a  document  abbreviation. 
Corrective  Action:    You  must  enter  a  value   for  this 

field. 

DOS- INVALID  DOCUMENT  ABBREVIATION 

Probable  Cause:  You  tried  to  add  or  change  a  document 
while  specifying  an  invalid  document 
abbreviation.  Valid  document  abbreviations 
are  contained  in  MPI  Document  number 
DOC-MPR-AIS.  If  one  document  combines  two 
or  more  document  types,  the  document 
abbreviations  must  be  separated  by  a  slash. 
For  example,  UM/MM/OM. 

Corrective  Action:  Reinput  after  verifying  according 
to  above  rules.  Contact  the  data  base 
administrator  if  a  new  document  requirement 
causes  the  above  rules  to  be  unattainable. 

D04-DEVEL  ACTIVITY  IS  A  MANDATORY  FIELD 

Probable  Cause:  You  tried  to  add  or  change  a  document 
without  specifying  a  development  activity. 
Documents  should  only  be  on  file  after  they 
have  been  assigned  to  a  development  activity 
for  action.  Therefore,  this  field  may  not 
be  left  blank. 

Corrective  Action:   Specify  a  development  activity. 

DOS- INVALID  DEVELOPMENT  ACTIVITY 

Probable  Cause:  You  tried  to  add  or  change  a 
development  activity  that  was  not  in  the 
database.  You  must  first  add  this 
development  activity  using  option  2  from  the 
Systems  Management  Add  Menu.  If  more  than 
one  development  activity  is  responsible  for 
the  document,  the  activity  abbreviations 
must  be  separated  with  a  slash.  For 
example,  DSA/IDEA. 

Corrective  Action:   Verify  and  reinput. 

DO 6 -STATUS  IS  A  MANDATORY  FIELD 
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Probable  Cause:  You  tried  to  add  or  change  a  life 
cycle  document  without  specifying  the 
status.   The  status  must  be  entered. 

Corrective  Action:   Enter  a  value  for  the  status. 

D07- INVALID  STATUS,  MUST  BE  P  OR  C 

Probable  Cause:  You  entered  an  invalid  status  for  the 
life  cycle  document.  All  documents  must 
either  be  pending  or  completed. 

Corrective  Action:   Enter  a  status  of  either  P  or  C. 

POl-MPI  ID  IS  A  MANDATORY  FIELD 

Probable  Cause:  You  tried  to  add  or  change  a  project 
without  specifying  a  value  for  MPI-ID.  This 
field  is  a  key  for  the  database  and  may  not 
be  left  blank. 

Corrective  Action:   Enter  an  MPI-ID. 

P02- SYSTEM  NAME  IS  A  MANDATORY  FIELD 

Probable  Cause:  You  tied  to  add  or  change  a  project 
without  specifying  the  system  name.  Each 
project  must  be  associated  with  a  system  and 
this  field  may  not  be  left  blank. 

Corrective  Action:   Enter  a  system  name. 

P03-THIS  SYSTEM  IS  NOT  ON  FILE 

Probable  Cause:    You  tried  to  add  or  change  a  project 

specifying  a  system  name  that  does  not  exist 

in  the  database. 
Corrective  Action:     You  must   first  add   this  system 

name  using  option  1  of  the  Systems  Add  Menu. 

P04- STATUS  MUST  BE  O  OR  C 

Probable  Cause:   You  entered  an  invalid  status  for  the 
project.    The  status  must  be  either  0  (for 
open)  or  C  (for  closed). 
Corrective  Action:   Enter  a  valid  status. 

P05-CATEGORY  MUST  BE  P,  S  OR  T 

Probable  Cause:  You  entered  an  invalid  category  for 
the  project.  The  category  must  be  P  (for 
production  mod),  S  (for  stand  alone)  or  T 
(for  Test  Cycle  modification). 

Corrective  Action:   Enter  a  valid  category. 

P06-DEVEL  ACTIVITY  IS  A  MANDATORY  FIELD 

Probable  Cause:    You  tried  to  add  or  change  a  project 
without  specifying   a  development   activity. 
Since  every  project  is  opened  for  a  specific 
activity,  this  field  may  not  be  left  blank. 
Corrective  Action:   Enter  a  development  activity. 

P07- INVALID  DEVELOPMENT  ACTIVITY 

Probable  Cause:  You  tried  to  add  or  change  a 
development  activity  that  was  not  on  file. 
You  must  first  add  this  activity  using 
option  2  from  the  Systems  Management  Add 
Menu.  If  more  than  one  activity  is 
responsible  for  the  project,  the  activity 
abbreviations  must  be  separated  with  a 
slash.  For  example,  HQMC/MCCDPA,  KCMO. 
Corrective  Action:   Verify  ana  reinput. 

P08- INVALID  NUMBER  TESTED 

Probable  Cause:  You  tried  to  input  a  number  of  test 
conditions  that  have  been  tested  that  was 
either  more  than  the  total  number  of  test 
conditions,  or  when  the  total  number  of  test 
conditions  has  not  yet  been  input. 

Corrective  Action:   Verify  and  reinput. 
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SOI -SYSTEM  NAME  IS  A  MANDATORY  FIELD 

Probable  Cause:    You  tried  to  add   or  change  a  system 

without   specifying  a   system   abbreviation. 

This  value  is   a  key  field  for   the  database 

and  may  not  be  left  blank. 
Corrective  Action:   Enter  a  system  abbreviation. 

S02- SYSTEM  NAME  MUST  BE  UNIQUE 

Probable  Cause:  You  tried  to  add  or  change  a  system 
abbreviation  that  already  is  defined  for 
another  system.  The  system  abbreviation 
must  be  a  unique  value.  Systems  that  are 
undergoing  major  enhancements  should  have  an 
asterisk  appended  to  the  system  name  to  make 
the  name  unique.  For  example,  ARMS  and 
ARMS*  are  two  existing  systems  in  the 
database. 

Corrective  Action:  Enter  a  unique  system 
abbreviation. 

SOS- INVALID  CATEGORY 

Probable  Cause:  You  tried  to  add  or  change  a  system 
with  an  invalid  category.  Valid  categories 
are  MCO,  MCD,  MCE,  DNO  or  DNE.  See  the 
discussion  of  categories  in  this  manual  for 
more  detail  concerning  categories. 

Corrective  Action:   Input  a  valid  category. 

S04- INVALID  CLASS-MUST  BE  I, II  OR  -0- 

Probable  Cause:    You  tried  to  add   or  change  a  system 

while  specifying   an  invalid   class.    Class 

definitions   are  contained   in  MCO   P5231. 1. 

Valid  classes  are  I,   II   or  a  null  value  if 

you  are  uncertain. 
Corrective  Action:   Input  a  valid  class. 

VOl-DEVEL  ACTIVITY  IS  A  MANDATORY  FIELD 

Probable  Cause:  You  tried  to  add  or  change  a 
development  activity  without  specifying  the 
abbreviation  for  that  activity.  This  is  a 
key  field  and  may  not  be  left  blank. 

Corrective  Action:  Enter  an  abbreviation  for  the 
development  activity. 

V02-THIS  ACTIVITY  ALREADY  EXISTS 

Probable  Cause:  You  tried  to  add  or  change  a 
development  activity  while  specifying  an 
abbreviation  of  an  activity  that  already 
exists.  The  activity  abbreviation  must  be 
unique. 

Corrective  Action:  Input  a  unique  development 
activity  abbreviation. 
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APPENDIX  C 
USER'S  MANUAL 

A.   GETTING  STARTED 

1.  System  Requirements. 

The  Marine  Corps  Automated  Systems  Management 
Information  System  (MCASMIS)  is  designed  to  run  in  conjunc- 
tion with  the  R: base  5000^  Database  Management  System  on  the 
IBM  PC,  PC-XT,  PC-AT  and  100%  compatible  microcomputers. 

Your  system  must  have  the  following: 

•  DOS,  version  2.0  or  higher. 

•  237K  of  main  memory  available  after   system  configura- 
tion.  A  minimum  of  320K  is  recommended. 

•  A  color  or  monochrome  monitor. 

•  A  hard  disk  drive  and  one  double-sided,   double-density 
5.25  inch  floppy  disk  drive. 

2.  Overview. 

MCASMIS  is  an  integrated  systems  and  project  manage- 
ment information  system  designed  to  enhance  the  sponsorship 
of  the  many  automated  systems  centrally  managed  at 
Headquarters,  U. S.  Marine  Corps.  Information  concerning 
automated  systems  and  projects  that  are  ongoing  concerning 
those  systems  is  available  in  many  different  formats. 

The  following  chapters  will  provide  detailed  expla- 
nations of  all  of  the  options  available  for  each  of  the 
management  functions. 

In  order  to  preserve  the  integrity  of  the  database, 
there  are  certain  functions  which  are  restricted  to  the 
database  administrator.  These  include  archiving  records  to 
a  history  file,  packing  the  database  to  recover  space 
assigned  to   records  that  have   been  deleted,    removing  all 


^R:base   5000  is   a   registered   trademark  of  Microrim, 
Inc. ,  Bellevue,  Washington. 
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history  records   to  a  diskette   to  recover  hard  disk  space, 
and  reorganizing  the  database   structure   to   accommodate 
future  requirements.    All  such  requests  should  be  forwarded 
to  the  database  administrator  for  action. 
3.   Special  Considerations. 

a.  On-Line  help. 

The  system  was  designed  to  be  menu  driven  and 
should  be  self  descriptive  in  most  cases.  From  any  of  the 
menu  screens  (which  are  lists  of  options  surrounded  by  a 
double-lined  border),  you  may  press  FIO  to  get  on-line 
instructions  concerning  that  particular  screen.  Further,  in 
many  of  the  query  options,  an  on-line  display  of  valid  argu- 
ments is  offered  if  no  records  that  match  your  response  are 
found  in  the  database. 

b.  Case  distinction.. 

There  is  no  distinction  made  between  upper  and 
lower  case  in  any  queries  made  against  the  database.  For 
example,  while  searching  for  a  system  by  the  name  of  RMS,  an 
input  of  rms,  RMS,  Rms,  etc. ,  would  all  work  exactly  the 
same.  While  entering  or  editing  a  record,  however,  you 
should  remember  that  the  data  that  is  retrieved  will  be 
displayed  in  the  case  in  which  it  was  entered.  If  you  enter 
a  record  into  the  database  with  a  first  name  of  John,  then 
John  will  always  be  displayed  when  this  record  is  selected, 
even  though  John  or  JOHN  was  the  string  on  which  you  were 
searching. 

c.  Null  values. 

Within  R;base,  null  values  are  stored  as  the 
symbol,  -0-.  This  is  the  symbol  that  will  be  displayed  when 
you  edit  a  record,  in  order  to  distinguish  it  from  a  field 
that  contains  all  blanks.  The  less  experienced  user  might 
find  the  difference  between  a  blank  and  a  null  value  to  be  a 
bit  nebulous.  However,  the  distinction  is  indeed  important 
in  record  selection.     While  entering  data  and   receiving 
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reports,   however,   null  values  will  be  displayed  as  blanks. 
This  approach  was  taken  to  give   the  output  a  more  profes- 
sional appearance.    For  the  purpose  of  reports  there  really 
is  no  difference  between  null  values  and  blanks. 

d.  Rules. 

R: base  allows  rules  to  be  defined  from  a  global 
perspective  which  performs  many  of  the  editing  functions. 
Any  attempt  to  enter  or  change  a  record  that  violates  any  of 
these  rules  will  be  disallowed  and  you  will  be  shown  an 
appropriate  error  message  and  number  on  the  screen.  Refer 
to  Appendix  B  for  more  information  on  each  of  these  error 
numbers. 

e.  Date  format. 

The  default  format  for  all  dates  has  been  set  to 
dd  mmm  yyyy.  For  convenience  in  inputting  or  editing  data, 
you  also  have  the  option  of  entering  dd/mm/yy  if  that  format 
is  more  natural.  That  is,  inputting  a  value  of  1  Feb  1985 
will  result  in  exactly  the  same  value  being  stored  as  when 
1/2/85  is  input.  If,  while  attempting  to  input  a  date, 
R: base  responds  with  an  error  message  saying  that  a  valid 
date  is  required,  check  the  format  and  reenter  according  to 
the  above  guidelines. 

f.  Backup  copies. 

Yoe  are   advised  to  make  frequent  backup  copies 
of  the  database  in  order  to   assist  in  recovering  from  inad- 
vertent loss  of  data  due  to  machine  or  operator  error. 
4.   Booting  the  System. 

MCASMIS  was  designed  to  run  on  a  hard  disk.  It  was 
designed  so  that  your  R: base  5000  programs  reside  in  a  sepa- 
rate directory  called  RBASE.  All  of  the  MCASMIS  programs 
should  reside  on  a  separate  directory  to  facilitate  backing 
up  the  programs  and  data.  From  this  directory,  type  in  the 
command, 

MCASMIS 
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and  the  system  will  take  over.  Remember  that  this  will  only 
work  properly  if  your  directory  with  the  R: base  5000 
programs  reside  on  a  directory  called  RBASE.  The  directory 
with  MCASMIS  programs  may  have  any  name.  Figure  C. 1  shows 
the  MCASMIS  Main  Menu  that  is  displayed  upon  first  entering 
the  system. 


( 
( 

( 

MCASMIS  MAIN  MENU 
' 1 )   SYSTEMS  MANAGEMENT 

2)   PROJECT  MANAGEMENT 
, 3 )   DATABASE  MANAGEMENT 

4)   RETURN  TO  OPERATING  SYSTEM 

Figure  C. 1    MCASMIS  Main  Menu. 

5.   Exiting  From  R; base. 

The  final  two  options  in  most  of  the  menu  screens 
allow  you  to  either  return  to  the  last  menu  or  to  return 
directly  to  the  top  menu.  This  last  option  was  included  in 
order  to  avoid  having  to  page  back  through  all  of  the 
preceding  menus  when  you  want  to  leave  this  application. 

B.   SYSTEMS  MANAGEMENT 

1.  General. 

If  option  1  is  selected   from  the  MCASMIS  Main  Menu, 
you  will   be  presented  with  the  menu   shown  in   Figure  C. 2. 
These  options   depict  standard  data  manipulation   functions 
that  will   route  you   to  the   appropriate  menu   for  detailed 
selection  as  described  in  succeeding  sections. 

2.  Adding  Systems  Records. 

Figure  C. 3  shows  the  options  that  are  available  if 
you  elect  to  choose  the  add  option  from  the  previous  menu. 

a.   Adding  a  system. 

When  the   need  arises  to   add  a  new   system  into 
the  existing  database,   you  should   select  option  1  from  the 
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SYSTEMS  MANAGEMENT  MAIN  MENU 

1)  ADD 

2  CHANGE 

3  DELETE 
4 )  QUERY 

5  MANAGEMENT  REPORTS 

6  RETURN  TO  MCASMIS  MAIN  MENU 


Figure  C.  2    Systems  Management  Main  Menu. 


SYSTEMS  MANAGEMENT  ADD  MENU 
1)   ADD  A  NEW  SYSTEM 

2  ADD  A  NEW  DOCUMENT 

3  ADD  A  NEW  DEVELOPMENT  ACTIVITY 

4)   RETURN  TO  SYSTEMS  MANAGEMENT  MAIN  MENU 
5    RETURN  TO  MCASMIS  MAIN  MENU 


Figure  C. 3    Systems  Management  Add  Menu. 

Add  Menu.  A  skeleton  input  form  will  be  displayed  on  the 
screen  and  you  will  input  the  system  abbreviation,  system 
name,  category  and  the  name  of  the  analyst  who  has  primary 
responsibility  for  that  system.  Valid  categories  to  be 
input  and  their  meanings  are: 

•  MCO  -  Marine  Corps  Operational  System 

•  MCD  -  Marine  Corps  System  under  Development 

•  DNO  -  Operational  System  DON/DOD 

•  DND  -  DON/DOD  System  under  Development 

You  will  then  be  prompted  to  input  additional 
items  based  on  the  category  of  that  system.  If  the  category 
was  an  operational  system,  you  will  be  prompted  for  a 
different  series  of  input  than  if  the  system  was  undergoing 
development.  Any  value  not  available  should  be  left  blank 
and  a  null  value  will  be  assigned  to  that  field  in  the  data- 
base. 
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The  system  name  that  is  added  must  be  UNIQUE. 
That  is,  that  name  should  not  already  exist  in  the  database. 
This  is  required  because  the  system  name  is  a  key  item  that 
must  point  to  a  unique  set  of  values  that  are  functionally 
dependent  on  that  system  name.  The  Rules  that  are  inher- 
ently defined  in  the  data  dictionary  will  preclude  you  from 
adding  a  non-unique  system  name,  and  it  will  provide  an 
error  message  if  you  should  attempt  to  do  so. 

Finally,  you  are  given  one  last  opportunity  to 
abort  from  this  add  function  by  pressing  the  escape  key 
(ESC),  or  to  add  the  record  by  pressing  the  page  down  key 
(PGDN).  Pressing  the  enter  key  (ENTER)  allows  you  to  tab  to 
the  next  input  area. 

If  you  added  a  system,  the  name  of  the  system 
added  will  be  displayed  and  you  will  be  asked  if  another 
system  is  to  be  added.  This  add  process  continues  until  you 
indicate  that  no  more  records  are  to  be  added  by  answering 
this  prompt  with  anything  other  than  "Y". 
b.   Adding  a  document. 

Option  2  provides  the  capability  to  add  a  new 
life  cycle  document.  This  record  should  be  added  at  the 
time  that  the  task  of  preparing  a  specific  document  is 
assigned,  with  a  status  of  P  (for  pending).  You  will  be 
presented  with  a  skeleton  form  to  input  values  for  the 
system  name,  the  document  abbreviation,  the  document  name, 
the  development  activity,  the  document  date  and  the  status. 
If  the  document  abbreviation  satisfies  more  than  one  type, 
they  should  be  separated  by  slashes.  For  example,  a  single 
document  that  serves  as  both  a  user's  manual  and  a  program 
maintenance  manual  should  be  input  as  UM/MM.  Like  the 
previous  option,  values  unavailable  for  any  field  should  be 
left  blank  and  a  null  value  will  be  stored  in  the  record. 
The  Enter  key  is  used  to  tab  to  the  next  input  area,  PGDN  to 
save  the  record  and  ESC  to  quit  without  saving  and  return  to 
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the  add  menu.  If  the  record  is  added,  you  are  shown  the 
name  of  the  activity  that  was  added  and  you  are  asked  if 
another  document  is  to  be  added.  This  process  continues 
until  you  respond  to  this  prompt  with  anything  other  than 
"Y". 

c.  Adding  a  development  activity. 

The  first  time  that  a  new  development  activity  is  contracted 
to  perform  work,  that  activity  should  be  added  to  the 
database.  Selection  of  option  3  provides  a  skeleton  input 
form  that  will  prompt  you  for  development  activity 
abbreviation,  full  name  of  the  activity,  point  of  contact, 
phone  number  and  full  address.  Blank  fields  will  be  stored 
as  null  values  and  the  Enter,  PGDN  and  ESC  keys  provide  the 
same  features  as  indicated  in  the  other  add  options.  You 
are  allowed  to  input  additional  development  activities  until 
anything  other  than  a  "Y"  is  input  to  the  continue  prompt. 

d.  Finished  adding. 

Option  4  will  return  control  to  the  Systems 
Management  Main  Menu. 

e.  Return  to  MCASMIS  main  menu. 

Selection  of  the  last  option  will  bypass  all 
intermediate  menus  and  control  is  passed  directly  to  the 
main  menu. 

3.   Editing  Systems  Data. 
Figure  C.  4  is   the  menu  presented  to  you  if   the  edit  option 
is  chosen  from  the  main  menu. 


SYSTEMS  MANAGEMENT  EDIT  MENU 

1)  EDIT  A  SYSTEM 

2)  EDIT  A  DOCUMENT  FOR  A  SYSTEM 

3)  EDIT  DEVELOPMENT  ACTIVITY  INFORMATION 

4)  RETURN  TO  SYSTEMS  MANAGEMENT  MAIN  MENU 

5)  RETURN  TO  MCASMIS  MAIN  MENU 


Figure  C.  4    Systems  Management  Edit  Menu. 
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a.  Editing  a  system. 

You  are  prompted  to  enter  the  abbreviation  for 
the  system  and  a  form  is  presented  for  editing.  Use  this 
option  to  change  analyst  name,  category,  assigned  due  dates 
for  life  cycle  documents,  or  any  other  data  element 
pertaining  to  the  system.  All  current  values  for  that 
record  are  displayed,  and  any  of  the  values  may  be  changed. 
Pressing  the  ENTER  key  TABS  to  the  next  input  area,  PGDN 
loads  the  record  after  changes  are  complete,  and  ESC  quits 
the  process  and  returns  to  the  edit  menu.  Control  is 
returned  to  the  edit  menu  when  you  press  ESC  or  have  elected 
to  load  the  edited  system. 

b.  Editing  a  document. 

When  you  select  this  option,  you  are  prompted  to 
enter  the  system  and  document  abbreviation  that  is  to  be 
modified.  A  form  is  presented  and  any  value  may  be  changed 
by  inputting  the  new  value  in  the  highlighted  field  and 
pressing  PGDN  to  store  it.  A  common  use  of  this  option 
would  be  to  change  the  status  from  P  to  C  when  the  document 
is  delivered.  Enter  tabs  to  the  next  input  area,  PGUP  finds 
the  next  match  and  ESC  quits  without  editing.  There  may  be 
multiple  records  in  the  file  for  a  certain  document  type  for 
one  system,  so  you  may  have  to  page  through  the  unwanted 
ones  in  order  to  get  to  the  document  in  error. 

c.  Editing  development  activity  information. 

If  a  development  activity  record  needs  to  be 
changed  due  to  changes  in  address,  name,  point  of  contact, 
etc. ,  option  3  should  be  selected  and  you  will  be  prompted 
for  the  name  of  that  activity.  Any  value  in  the  record  may 
be  changed  by  typing  over  the  old  information  in  the  high- 
lighted area  and  pressing  PGDN  to  save  it.  ENTER  tabs  to 
the  next  input  area  and  ESC  quits  without  modifying  the 
record  contents. 
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d.  Finished  editing. 

Option  4   returns   control   to   the   Systems 
Management  Main  Menu. 

e.  Return  to  MCASMIS  main  menu. 

Selection  of   this  option  bypasses   all  interme- 
diate menus  and  control  is  passed  directly  to  the  main  menu. 

4.  Deleting  Systems  Records. 
Figure  C. 5  is  the  menu  presented  when  option  3  is  selected 
from  the  Systems  Management  Main  Menu.  In  all  of  the 
following  delete  options,  you  are  asked  to  verify  that  the 
record  should  be  deleted  before  that  deletion  is  executed. 
This  ounce  of  prevention  may  seem  cumbersome  if  you  tire  of 
giving  commands  more  than  once.  However,  the  additional 
safety  against  inadvertently  deleting  a  record  by  hitting  a 
wrong  key  will  more  than  compensate  for  this  inconvenience. 


SYSTEMS  MANAGEMENT  DELETE  MENU 

'1] 

DELETE  A  SYSTEM 

2 

DELETE  A  DOCUMENT 

P 

DELETE  A  DEVELOPMENT  ACTIVITY 

4 

RETURN  TO  SYSTEMS  MANAGEMENT  MAIN  MENU 

5 

RETURN  TO  MCASMIS  MAIN  MENU 

Figure  C. 5    Systems  Management  Delete  Menu. 

a.   Deleting  a  system. 

You  are  prompted  for  a  system  name  when  this 
option  is  selected.  A  form  is  presented  which  contains  all 
current  values  for  that  record.  You  press  PGDN  to  delete 
this  record  or  ESC  to  quit  the  process  without  deleting.  If 
any  open  projects  are  on  file  for  the  system,  you  are 
advised  that  deletion  will  not  be  allowed  until  those 
projects  are  either  closed  or  deleted.  However,  it  should 
be  noted  that  documents  pertaining  to  any  system  that  is 
deleted  must  be  deleted  individually  using  option  2  of  this 
menu. 
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b.  Deleting  a  document. 

You  are  prompted  for  a  document  and  a  system 
abbreviation  and  is  then  shown  records  that  satisfy  those 
criteria  one  at  a  time.  You  press  PGDN  to  delete  that  docu- 
ment, PGUP  to  find  the  next  matching  document,  or  ESC  to 
quit  and  return  to  the  delete  menu. 

c.  Deleting  a  development  activity. 

You  are  prompted  for  a  development  activity  abbreviation  and 
is  then  shown  the  fields  for  that  selection  on  a  labeled 
form.  You  again  press  PGDN  to  delete  that  record  or  ESC  to 
quit  without  deleting.  Control  is  returned  to  the  delete 
menu  when  no  matching  record  is  found  or  ESC  is  pressed. 

d.  Finished  deleting. 

Option  4  returns  control  to  the  Systems 
Management  Main  Menu. 

e.  Return  to  MCASMIS  main  menu. 

Selection  of   this  option  bypasses   all  interme- 
diate menus  and  control  is  passed  directly  to  the  main  menu. 
5.   The  Systems  Query  Process. 

Selecting  option  4  from  the  main  menu  displays  the 
menu  shown  in  Figure  C.  5  to  you.  Queries  are  generally 
nonrecurring,  ad  hoc  request  that  require  you  to  first 
answer  a  prompt  to  delineate  the  search  criteria.  This 
subsystem  is  designed  to  answer  the  types  of  questions  that 
are  presented  below. 

a.   Changing  the  designated  output  device. 

Option  one  enables  you  to  change  the  output 
device  from  the  screen  to  printer.  If  this  option  is 
selected,  the  menu  shown  in  Figure  C. 7  is  presented  for  you 
to  designate  the  output  device.  Once  chosen,  the  output 
device  remains  in  effect  until  the  current  menu  is  exited, 
or  you  again  change  the  output  designation  using  this 
option.  There  are  two  important  features  of  this  option  as 
follows. 
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SYSTEMS  MANAGEMENT  QUERY  MENU 

1)  CHANGE  OUTPUT  DEVICE 

2)  CUSTOMIZED  TALLY  BY  COLUMN 

3)  SELECT  DOCUMENTS  BY  SYSTEM 

4)  SELECT  SYSTEMS  BY  DOCUMENT  TYPE 

5)  LIST  DATA  DICTIONARY 

6)  SELECT  DOCUMENT  &   SYSTEM  BY  DEVELOPMENT  ACTIVITY 

7)  SELECT  ALL  INFORMATION  ABOUT  ONE  SYSTEM 
8  RETURN  TO  SYSTEMS  MANAGEMENT  MAIN  MENU 
9)  RETURN  TO  MCASMIS  MAIN  MENU 


Figure  C.  6    Systems  Management  Query  Menu. 

When  the  printer  is  selected  as  the  output 
device,  output  will  be  routed  simultaneously  to  the  screen 
also.  This  allows  you  the  opportunity  to  manually  adjust 
the  paper  form  feed  at  the  top  of  each  new  page  of  output 
before  proceeding  by  pressing  any  key. 

Not  all  of  the  queries  and  management  reports 
may  be  routed  directly  to  the  printer.  Those  reports  which 
disallow  this  designation  (for  example,  those  that  use  skel- 
eton forms),  are  specified  in  the  help  screens  for  each 
subsystem.  Having  the  output  designation  set  to  printer 
when  choosing  these  restricted  options  will  have  no  effect 
and  the  output  will  still  be  presented  to  the  screen. 


SELECT  OUTPUT  MENU 
SCREEN    PRINTER 


Figure  C.  7    Select  Output  Menu. 

b.   Customized  tally  by  column. 

This  is  one  of  the  more  flexible  queries  in  the 
subsystem.  It  provides  a  count  of  the  number  of  occurrences 
with  each  value  in  the  database.  For  example,  "tally 
analysts  in  system"  would  list  the  names  of  every  analyst  on 
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file  and  how  many  systems  for  which  they  had  responsibility. 
Similarly,  "tally  devact  in  doclist"  would  search  the 
doclist  table  and  provide  the  names  of  every  development 
activity  and  how  many  documents  each  had  prepared.  You  are 
first  presented  with  a  list  of  all  tables  in  the  database. 
After  choosing  one  of  these  tables,  you  are  presented  with  a 
list  of  columns  that  comprise  the  table  selected.  Appendix 
B  lists  all  tables,  columns  and  column  definitions. 
Although  this  option  does  require  some  familiarity  with  the 
database  structure,  a  little  practice  using  this  command  in 
conjunction  with  the  data  dictionary  provided  will  reap 
great  benefits  in  establishing  valuable  insight  into  the 
contents  of  the  database.  The  possibilities  are  endless; 
for  example:  How  many  projects  for  each  system  could  be 
obtained  by,  tally  sysname  in  project.  Or  tally  docabr  in 
doclist  would  give  information  on  how  many  of  each  type  life 
cycle  document  existed  on  file. 

c.  How  well  is  this  system  documented? 

After  selecting  option  3,  you  are  prompted  for  a 
system  abbreviation.  The  document  abbreviation,  document 
title,  development  activity  and  document  date  are  displayed 
for  all  documents  that  pertain  to  that  system.  The  output 
includes  documents  that  are  currently  being  prepared  as  well 
as  those  that  have  been  completed. 

d.  Where   can   I   find  a   sample   of   a   Functional 
Description? 

To  get  an  idea  of  what  documents  exist,  and  what 
development  activities  have  experience  in  writing  that 
particular  document  type,  you  select  option  4  and  are 
prompted  for  a  document  abbreviation.  You  are  then 
presented  with  the  system  name,  development  activity,  docu- 
ment title   and  document  date   for  all  documents   that  match 
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that  abbreviation. 

e.  What  are  the  database  definitions? 

Option  5  provides  an  on-line  data  dictionary 
that  lists  all  column  names  with  the  tables  names  that 
contain  that  field,  plus  a  listing  of  each  individual  table 
with  format  of  the  fields  and  whether  or  not  that  field  is  a 
key  value.  Key  fields  enable  faster  searching  by  indexing 
the  values  of  those  fields  separately  and  the  inexperienced 
user  should  not  be  concerned  with  this  information. 
Although  not  essential,  it  is  recommended  that  this  option 
be  designated  to  the  printer  output  device. 

f.  What  documents  has   this   contractor   authored 
before? 

After  selecting  option  6,  you  are  prompted  to 
input  an  abbreviation  for  a  development  activity.  You  are 
then  shown  the  system  name,  document  abbreviation,  document 
title,  document  date  and  development  activity  for  all  docu- 
ments on  file  for  which  this  activity  authored  or  coau- 
thored.  The  development  activity  is  displayed  because  in 
many  cases,  the  document  was  coauthored  by  more  than  one 
contractor  and  this  fact  should  be  known  when  evaluating 
this  question. 

g.  Selecting  all  information  about  a  system. 

You  are  prompted  for  a  system  abbreviation  and 
are  shown  all  information  pertaining  to  that  system  on  a 
labeled  form.  After  pressing  any  key,  the  query  menu  will 
be  redisplayed. 

h.   Finished  querying. 

Option  8  returns  control  to  the  Systems 
Management  Main  Menu. 

i.   Return  to  operating  system. 

Option   9  bypasses   all   intermediate  menus   and 
control  is  returned  directly  to  the  operating  system. 
5.   Systems  Management  Reports. 
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While  the  preceding  options  are  often  useful  in 
generating  answers  to  ad  hoc  requests,  this  option  is  really 
the  backbone  of  the  Systems  Management  subsystem.  Figure 
C. 8  depicts  the  sixteen  options  that  are  available  to  you 
after  selecting  the  Management  Reports  Option  from  the 
Systems  Management  Main  Menu. 


SYSTEMS  MANAGEMENT  MANAGEMENT  REPORTS 
CHG  OUTPUT   DOCS  DUE     TASK  DOCS    PEND  PROJS 
PEND  DOCS    NEED  DATA    LIST  SYSTS   LIST  DOCS 
LIST  VENDS   ANALYSTS     SYSTEMS      OPER  VIEW 
DEVEL  VIEW   HELP         RETURN       EXIT 


Figure  C. 8    Systems  Management  Management  Reports. 

Table  X  provides  a  list  of   the  reports  that   are  generated 
upon  your  request. 

C.   PROJECT  MANAGEMENT 

1.  General. 

Selection  of  option  2  from  the  MCASMIS  Main  Menu 
will  cause  the  menu  shown  in  Figure  C. 9  to  be  presented. 
This  menu  should  look  very  familiar  since  it  is  virtually 
identical  to  the  initial  options  presented  under  Systems 
Management.  The  following  sections  provide  detailed 
descriptions  of  each  of  these  options. 

2.  Adding  Proi  act  Records. 

Figure  C.  10  shows  the  options   that  are  available  if 
you  select  the  add  option  from  the  previous  menu, 
a.   Adding  a  new  project. 

To  add  a  new  project  to  the  database,  you  select 
option  1  and  are  presented  with  a  skeleton  form  in  which  to 
input  various  pieces  of  information. 

The  MPI-ID,  system  name  and  development  activity 
fields  are  mandatory  and  may  not  be  left  blank.    The  system 
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TABLE  X 
SYSTEMS  MANAGEMENT  REPORTS 


CHG  OUTPUT 
DOCS  DUE 

TASK  DOCS 

PEND  DOCS 
PEND  PROJS 

NEED  DATA 

LIST  SYSTS 

LIST  DOCS 
LIST  VENDS 

ANALYSTS 

SYSTEMS 
OPER  VIEW 
DEVEL  VIEW 
HELP 
RETURN 
EXIT 


Enables  you  to  change  the  output  device  to 
which  the  selected  reports  are  routed  to  screen 
or  screen  with  printer. 

These  options  prompt  you  for  the  number  of  days 
in  the  future  on  which  to  base  the  search,  and 
display  the  system  name  and  the  scheduled  date 
that  the  indicated  document  was  due  but  as  yet 
has  not  been  completed. 

Provides  a  listing  of  the  system  names  and  the 
scheduled  dates  for  all  indicated  documents 
that  have  assigned  due  dates,  but  have  not  yet 
been  tasked  to  anyone  to  complete. 

Lists  all  pending  documents  (not  yet  completed/ 
delivered) . 


Lists  all  open  projects  for 
You  are  prompted  to  enter  a 
this  option. 


a  given   system, 
system  name   for 


Checks  the  database  and  provides  a  listing  of 
data  items  that  are  missing  for  operational 
systems. 

Provides  a  listing  of  all  automated  systems  in 
the  database  sorted  by  category  and  system 
name. 


Provides   a  listing  of   all 
database  sorted  by  system. 


documents  in  the 


Provides  a  listing  of  all  development  activi- 
ties and  their  phone  numbers  in  alphabetical 
order. 

Provides  a  listing  of  analyst  name,  system 
name,  category  and  long  title  sorted  by 
analyst. 


Provides  the   same  listing   as  ANALYSTS 
the  sort  order  is  by  system  name. 


Provides   an  overview 
tional  systems. 


Provides  an   overview  of  Marine 
ment  and  development  systems. 

Provides  on-line  help  for 
reports. 

Returns  control  to  the 
Menu. 


except 
em  name. 

of   Marine  Corps   opera- 
Corps  enhance- 
the  above  management 
Systems  Management  Main 


Leaves  the  MCASMIS  System  and  returns  control 
to  the  operating  system  after  closing  the 
database. 
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PROJECT  MANAGEMENT  MAIN  MENU 

1)  ADD 

2 )  CHANGE 

3 )  DELETE 

4 )  QUERY 

5)  MANAGEMENT  REPORTS 

6  RETURN  TO  MCASMIS  MAIN  MENU 


Figure  C. 9   Project  Management  Main  Menu. 


PROJECT  MANAGEMENT  ADD  MENU 
1)   ADD  A  NEW  PROJECT 
2    ADD  TTC  TO  EXISTING  PROJECT 
3)   ADD  DELIVERABLE  TO  EXISTING  PROJECT 

4  RETURN  TO  PROJECT  MANAGEMENT  MAIN  MENU 

5  RETURN  TO  MCASMIS  MAIN  MENU 


Figure  C. 10   Project  Management  Add  Menu. 

name  and  development  activity  that  are  being  added  must 
already  be  in  the  database.  If  not,  an  error  message  will 
be  displayed  and  you  should  use  the  appropriate  option  from 
the  Systems  Management  subsystem  to  add  this  record. 

The  status  field  refers  to  whether  the  project 
is  open  or  closed.  Enter  an  0  if  the  project  is  just  being 
added,  later  using  the  change  process  to  modify  the  status 
to  C  for  closed. 

Valid  categories  are  P  if  the  project  entails  a 
production  modification  to  an  existing  application,  an  S  if 
the  project  is  a  stand  alone  product,  or  a  T  if  the  project 
is  included  in  a  Test  Cycle  environment. 

All  other  values  may  be  left  blank  if  the  infor- 
mation is  not  available  at  the  time  the  project  is  being 
opened. 
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After  entering  the  applicable  data,  you  press 
PGDN  to  load  the  new  record  or  ESC  to  abort  the  load 
process.  ENTER  allows  you  to  tab  repeatedly  to  the  next 
input  area.  If  PGDN  is  pressed,  the  entered  information  is 
validated  in  accordance  with  the  rules  specified  above.  If 
the  information  is  valid,  the  record  is  added  and  you  are  so 
informed.  If  not,  an  appropriate  error  message  is 
displayed. 

If  the  project  being  added  pertains  to  either 
JUMPS/MMS  or  REMMPS,  you  are  then  prompted  to  enter  the  Type 
Transaction  Codes  (TTC)  that  are  being  modified,  deleted  or 
created  by  this  project. 

After  adding  any  project,  you  are  given  the 
opportunity  to  add  the  names  of  one  or  more  deliverables 
that  are  to  be  received  as  part  of  that  project.  The  ENTER 
key  loads  the  deliverable,  and  ESC  aborts  the  process  and 
returns  to  the  Project  Management  Add  Menu. 

b.   Adding  a  TTC  to  an  existing  project. 

Option  2  provides  the  capability  to  add  a  TTC  to 
an  already  existing  project.  Often  times,  after  a  project 
has  been  submitted,  subsequent  analysis  of  the  problem  or 
requirements  uncover  ramifications  to  additional  TTCs  than 
those  that  were  originally  identified.  This  option  permits 
the  addition  of  those  TTCs  and  maintains  the  integrity  of 
the  database. 

You  are  first  prompted  to  enter  the  MPI  project 
ID  number  of  the  existing  project.  If  no  such  project  is  on 
file,  an  error  message  is  displayed.  If  the  project  number 
is  valid  (i.e.,  it  already  exists  on  file),  you  are 
presented  with  a  form  to  add  as  many  TTCs  as  desired. 

Control  is  returned  to  the  Project  Management 
Add  Menu  when  you  indicate  that  you  do  not  desire  to  add  a 
TTC  to  any  more  projects  at  the  given  prompt. 
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c.  Adding  a  deliverable  to  an  existing  project. 
Option  3  allows   you  to  add  a  deliverable  to  an 

existing  project.  As  in  the  option  for  adding  a  TTC  to  an 
existing  project,  you  are  prompted  to  enter  the  MP I  project 
ID  number  and  the  validity  of  this  number  id  first  checked 
before  prompting  you  to  input  the  deliverable. 

Control  is  returned  to  the  Project  Management 
Add  Menu  when  you  indicate  that  deliverables  are  not  to  be 
added  to  any  more  projects. 

d.  Finished  adding. 

Option  4  will  return  control  to  the  Project 
Management  Main  Menu. 

e.  Return  To  MCASMIS  main  menu. 

Selection  of   option  5  will  bypass   all  interme- 
diate menus  and  pass  control  directly  to  the  main  menu. 
3.   Editing  Project  Data. 

If  you  select  the  change   option  from  the  main  menu. 
Figure  C.  11  is  presented. 


PROJECT  MANAGEMENT  EDIT  MENU 

1)  EDIT  A  PROJECT 

2)  EDIT  A  DELIVERABLE  FOR  A  PROJECT 

3  RETURN  TO  PROJECT  MANAGEMENT  MAIN  MENU 

4  RETURN  TO  MCASMIS  MAIN  MENU 


Figure  C. 11    Project  Management  Edit  Menu. 

a.   Editing  a  project. 

You  are  prompted  to  enter  the  MPI  project  iden- 
tification number.  If  no  such  project  exists,  an  error 
message  is  displayed.  If  valid,  a  form  is  presented  with 
all  values  displayed  for  that  project  and  you  may  edit  any 
desired  field  except  for  the  MPI  ID  field.  ENTER  tabs  to 
the  next  input  field,  PGDN  loads  the  record  and  you  are 
informed  of  a  successful  load,  and  ESC  aborts  the  edit 
process. 
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No  priority  may  be  assigned  or  changed  to  a 
value  that  is  higher  than  the  number  of  projects  on  file  for 
that  development  activity  that  have  an  open  status.  The 
system  will  automatically  assign  it  a  priority  of  the 
highest  number  if  the  field  is  left  blank  or  if  an  attempt 
is  made  to  assign  a  priority  that  is  too  large. 

Also,  if  the  priority  is  modified  during  this 
edit  process,  all  other  priorities  for  open  projects  for 
that  activity  are  automatically  adjusted.  After  modifying  a 
priority,  get  a  listing  of  projects  by  priority  (option  5 
from  the  Project  Management  Query  Menu)  to  see  the  results. 

Control  is  returned  to  the  Project  Management 
Edit  Menu  when  you  elect  to  either  load  the  modified  record, 
or  abort  by  pressing  the  ESC  key. 

b.  Editing  a  deliverable  for  a  project. 

As  in  the  previous  option,  you  are  prompted  to 
enter  an  MPI  project  identification  number  and  this  input  is 
validated.  If  valid,  you  are  shown  all  deliverables  on  file 
for  that  project,  one  at  a  time,  and  are  permitted  to  modify 
the  description  of  that  deliverable. 

Since  there  may  be  more  than  one  deliverable  for 
any  project,  you  may  have  to  page  through  all  of  them  before 
getting  to  the  one  desired.  PGDN  loads  the  modified  record, 
PGUP  finds  the  next  deliverable  for  that  project  and  ESC 
aborts  the  process  and  returns  to  the  Project  Management 
Edit  Menu. 

c.  Finished  editing. 

Option  3  returns  control  to  the  Project 
Management  Main  Menu. 

d.  Return  to  the  MCASMIS  main  menu. 

Selection  of   this  option  bypasses   all  interme- 
diate menus  and   returns  control  directly  to   the  main  menu. 
The  built  in  RULES  preclude  editing  data  to  an  illegal  value 
in  all  of  the  editing  options. 
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4.   Deleting  Project  Records. 

Figure  C. 12  is  the  menu  presented  when  option  3  is 
selected  from  the  Project  Management  Main  Menu.  As  in  the 
Systems  Management  delete  process,  you  are  asked  to  verify 
the  deletion  before  execution. 


PROJECT  MANAGEMENT  DELETE  MENU 

1)  DELETE  A  SINGLE  PROJECT 

2)  DELETE  ALL  PROJECTS  FOR  ONE  SYSTEM 

3)  DELETE  A  TTC  FOR  A  PROJECT 

4)  DELETE  A  DELIVERABLE  FOR  A  PROJECT 

5)  RETURN  TO  PROJECT  MANAGEMENT  MAIN  MENU 

6)  RETURN  TO  MCASMIS  MAIN  MENU 


Figure  C. 12    Project  Management  Delete  Menu. 

a.  Deleting  a  single  project. 

You  are  prompted  to  enter  the  MP I  project  iden- 
tification number  and  an  error  message  is  displayed  if  the 
project  is  not  on  file.  If  the  record  is  found,  a  form  with 
all  values  for  that  project  is  displayed  and  you  press 
either  PGDN  to  delete  the  record  or  ESC  to  abort  the  delete 
process. 

If  PGDN  is  pressed,  you  are  asked  to  verify  that 
the  delete  is  correct  before  proceeding. 

When  a  project  is  deleted,  all  projects  of  lower 
priority  are  automatically  adjusted.  Also,  all  TTC  and 
deliverable  records  on  file  for  this  project  are  automati- 
cally deleted  when  the  project  is  deleted. 

b.  Deleting  all  projects  for  one  system. 

You  are  prompted  to  enter  the  system  abbrevia- 
tion and  are  given  the  opportunity  to  verify  that  the  delete 
should  be  executed.  Again,  all  priorities  are  automatically 
adjusted  as  a  result  of  any  projects  deleted  by  this  option. 
TTC  and  deliverable  records  for  these  projects  are  also 
automatically  deleted. 
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c.  Deleting  a  TTC  for  a  project. 

You  are  prompted  to  enter  the  MPI  project  iden- 
tification number  and  are  then  shown  all  TTC  records  on  file 
for  that  project  one  at  a  time.  Pressing  PGDN  deletes  the 
TTC,  PGUP  finds  the  next  TTC  record  for  that  project  and  ESC 
aborts  the  process  and  returns  control  to  the  Project 
Management  Delete  Menu. 

d.  Deleting  a  deliverable  for  a  project. 

After  answering  the  prompt  for  the  MPI  project 
identification  number,  you  are  shown  all  deliverable  records 
one  at  a  time  and  again  press  PGDN  to  delete  the  record, 
PGUP  to  find  the  next  match  or  ESC  to  return  control  to  the 
Project  Management  Delete  Menu  without  deleting. 

e.  Finished  deleting. 

Option  5  returns  control  to  the  Project 
Management  Main  Menu. 

f.  Return  to  MCASMIS  main  menu. 

Selection  of  this  last  option  again  bypasses  all 
intermediate  menus  and  returns  control  to  the  main  menu. 
5.   The  Project  Query  Process. 

Selecting  the  query  option  from  the  Project 
Management  Main  Menu  will  display  the  menu  shown  in  Figure 
C.  13. 


PROJECT  MANAGEMENT  QUERY  MENU 

1)  CHANGE  OUTPUT  DEVICE 

2)  ALL  OPEN  PROJECTS  SORTED  BY  SYSTEM 

3)  ALL  OPEN  PROJECTS  FOR  ONE  SYSTEM 

4)  ALL  OPEN  PROJECTS  SORTED  BY  SCHEDULED  DUE  DATE 

5)  ALL  OPEN  PROJECTS  FOR  AN  ACTIVITY  BY  PRIORITY 

6)  TTC  CROSS  REFERENCE  MENU 

7)  ALL  INFORMATION  ON  A  PARTICULAR  PROJECT 
8  RETURN  TO  PROJECT  MANAGEMENT  MAIN  MENU 
9)  RETURN  TO  MCASMIS  MAIN  MENU 


Figure  C. 13    Project  Management  Query  Menu. 
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The   following  types   of  questions   are   answered  by  this 
subsystem. 

a.  Changing  the  output  device. 

This  option  works  exactly  the  same  as  it  does  in 
the  systems  management  subsystem. 

b.  In  which  systems  is  work  being  performed? 

This  option  provides  the  overall  picture  of  all 
open  projects  sorted  by  the  system  in  which  the  work  is 
being  performed,  and  the  priority  assigned  to  that  project. 
The  scheduled  due  date  of  each  project  is  also  included  and 
you  can  see  at  a  glance  which  projects  and  which  systems 
require  additional  attention. 

c.  What  work  is  being  done  in  my  system? 

This  option  provides  the  responsible  analyst  to 
get  a  listing  of  all  open  projects  for  that  system  sorted  by 
priority. 

d.  Which  projects  are   scheduled  to  be   completed 
next? 

All   open  projects   are  listed   sorted  by  the 

scheduled  due  date.    Projects  that   are  overdue  can  be  seen 

at  a  glance  and  given  immediate  attention. 

e.  What  projects  are  being  done  at  one  activity? 
You  are  prompted  to  input  the  activity  abbrevia- 
tion and  are   shown  a  listing  of  all  open  projects  for  that 
activity  sorted  by  priority. 

f.  Which  project(s)  modified  TTC  020? 

This  option  could  be  invaluable  for  tracking 
down  the  cause  of  a  production  problem.  Also  available  with 
this  option  is  the  answer  to,  "what  TTCs  were  modified  by  a 
given  project".   You  elect  which  criterion  to  set. 

g.  Selecting  all  information  about  a  project. 

You  are  prompted  for  the  MPI  project  identifica- 
tion number  and  are  then  shown  all  information  pertaining  to 
that  system  on  a  labeled  form.  Any  TTC  or  deliverable 
information  connected  with  that  project  is  also  displayed. 
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h.   Finished  querying. 

Option  8  returns  control  to  the  Project 
Management  Main  Menu. 

i.   Return  to  MCASMIS  main  menu. 

Selection  of  this  last  option  bypasses  all 
intermediate  menus  and  returns  control  directly  to  the  main 
menu. 

6.   Project  Management  Reports. 

Figure  C. 14  depicts  the  menu  presented  when  the 
management  reports  option  is  selected  from  the  Project 
Management  Main  Menu. 


PROJECT  MANAGEMENT  MANAGEMENT  REPORTS 

1)  CHANGE  OUTPUT  DEVICE 

2)  OPEN  PROJECTS  THAT  ARE  OVERDUE  OR  DUE  SOON 

3)  PROJECTS  BY  FUNCTIONAL  OR  ACTIVITY  PROJECT  OFFICER 

4)  LOG  OF  PROJECTS  BY  DATE  OF  MP I  REQUEST 

5  LOG  OF  DELIVERABLES  FOR  PROJECTS  ON  FILE 

6  LOG  OF  PROJECTS  BY  SCHEDULED  DUE  DATE 

7  TEST  CYCLE  STATUS  REPORT 

8)  RETURN  TO  PROJECT  MANAGEMENT  MAIN  MENU 

9  RETURN  TO  MCASMIS  MAIN  MENU 


Figure  C. 14   Project  Management  Management  Reports. 

Table  XI  provides   a  list  of  the  reports   that  are  generated 
at  your  request. 

D.   DATABASE  MANAGEMENT 
1.   General 

Most  of  the  functions  of  the  Database  Management 
subsystem  should  be  restricted  to  the  system  manager  located 
at  Headquarters,  U. S.  Marine  Corps.  Only  option  1  should  be 
used  by  all  other  users  of  the  system.  Future  versions  of 
the  MCASMIS  system  will  incorporate  security  to  ensure  that 
unauthorized  users  of  these  options  do  not  jeopardize  the 
integrity  of  the  database. 
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TABLE  XI 
PROJECT  MANAGEMENT  REPORTS 

1  -  Enables  you   to  change   the  output   device  to   which  the 

subsequent  reports  are  routed, 

2  -  Provides   a   detailed   report  by   system   of   all   open 

projects  including  the  priority  and  scheduled  due  date. 

3  -  Provides   a  list  of  projects  under   the  cognizance   of 

either  a   functional  or  activity  project  officer  sorted 
by  MP I  ID  number. 

4  -  Provides  a  detailed   log  of  all  MPI   requests,   with  the 

most  recent  requests  shown  first. 

5  -  Provides  a  detailed  listing  of  all  deliverables  on  file, 

sorted  by  MPI  project  identification  number. 

5  -  Provides  a  listing  of  all  open  projects,  with  the 
earliest  scheduled  due  dates  appearing  first. 

7  -  Produces  a  test  cycle  status  report  sorted  by  activity 
project  identifiers  for  use  in  tracking  the  quality 
control  being  performed  by  the  development  activity. 


Unfortunately,  because  of  the  special  configuration 
considerations  involved  with  the  distributed  processing 
sites,  this  security  cannot  be  added  at  the  present,  since 
these  remote  sites  require  the  capabilities  of  option  1  to 
transmit  their  input  data  to  HOMC  for  consolidation. 

Figure  C. 15  shows  the  menu  that  is  displayed  to  you 
when  the  database  management  option  is  selected  from  the 
main  menu. 


DATABASE  MANAGEMENT  MAIN  MENU 

1)  UNLOAD  DATA  TO  SEND  TO  HOMC 

2)  MERGE  DATA  FROM  DISTRIBUTED  SITES 

3  PACK  DATABASE  TO  RECOVER  UNUSED  SPACE 

4)  ARCHIVE  RECORDS 

5)  REMOVE  ALL  ARCHIVED  RECORDS  TO  HISTORY 

6)  RETURN  TO  MCASMIS  MAIN  MENU 


Figure  C. 15   Database  Management  Main  Menu. 
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2.   Unloading  Data  to  Send  to  HOMC 

This  is  normally  the  only  option  that  should  ever  be 
selected  by  any  user  other  than  the  system  manager  at  HQMC. 
It  enables  you  to  unload  all  data  pertaining  to  projects, 
including  associated  TTC  and  deliverable  records,  for 
subsequent  transmittal  to  HQMC  for  consolidation.  It  is 
envisioned  that  this  file  will  be  small  enough  to  allow 
rapid  transmission  over  standard  voice  telephone  lines  from 
micro  to  micro.  While  2400  baud  modems  will  provide  faster 
response,  the  current  1200  baud  modems  should  be  sufficient 
to  accomplish  this  data  transfer. 

Of  course,  depending  on  the  urgency  of  the  need  for 
updated  data,  the  diskette  containing  this  data  could  even 
be  mailed  if  the  situation  so  dictated. 

You  should  first  have  a  pre  formatted  diskette  that 
does  not  contain  any  data  already  on  it.  You  are  presented 
with  the  prompt  for  which  drive  will  contain  the  data  that 
is  to  be  unloaded.  Only  drives  A  and  B  are  valid  for  this 
purpose.  After  properly  answering  this  prompt,  all  of  the 
data  is  automatically  unloaded  and  you  are  returned  to  the 
MCASMIS  Main  Menu. 

It  is  very  important  that  no  additional  data  be 
added  at  the  remote  site  until  the  new  database  diskette  is 
returned  from  HQMC.  This  manual  coordination  is  required  to 
keep  the  data  synchronized  because  of  the  unique  peculiari- 
ties of  the  configuration. 

When  the  new  diskette  is  returned  from  HQMC,  you 
should  load  that  diskette  into  either  drive  A  or  B,  and  from 
the  MCASMIS  directory,  issue  the  DOS  copy  command  with  that 
drive.   For  example, 

COPY  A:MCMIS*.  RBS 
This  command  should  be  typed  exactly  as  shown,  including  the 
asterisk,   with  only  the  drive   designator  allowed  to  change 
to  be  either  A  or  B  as  appropriate. 


142 


3.  Merging  Data  from  Remote  Sites  at  HOMC 

The  data  that  was  unloaded  by  you  at  the  remote  site 
is  in  an  ASCII  file  with  embedded  R:  base  5000  commands  that 
will  allow  merging  this  data  into  the  MCASMIS  database.  If 
this  data  was  transmitted  over  telephone  lines,  the  receiver 
should  give  it  a  filename  of  "OUT#DATA".  If  the  data  disk- 
ette was  received  via  mail,  it  will  already  have  this  file- 
name. 

The  receiver  simply  places  this  diskette  into  either 
drive  A  or  B,  and  answers  the  first  question  with  that  drive 
letter.  A  message  is  displayed  telling  you  to  standby  while 
the  data  is  input  and  all  duplicate  records  are  automati- 
cally deleted. 

You  should  then  insert  an  empty,  formatted  diskette 
into  either  drive  A  or  B,  and  answer  the  next  prompt  for 
which  drive  should  contain  the  data  to  be  returned  to  the 
remote  site.  Then,  the  data  is  automatically  reloaded,  all 
space  is  recovered  from  the  deleted  records,  and  both  the 
hard  disk  and  the  floppy  diskette  will  contain  the  updated, 
complete  database. 

The  floppy  diskette  will  then  be  mailed  to  the 
remote  site.  You  will  use  the  DOS  copy  command  to  copy  the 
new  database  at  the  remote  site,  and  the  system  can  then 
continue  to  be  used.  Control  is  returned  to  the  Database 
Management  Main  Menu  at  the  conclusion  of  this  action. 

4.  Packing  the  Database 

When  records  are  deleted  from  the  database,  the 
space  formerly  occupied  by  those  records  is  still  not 
useable  until  the  database  is  either  packed  or  reloaded. 
Option  3  allows  the  system  manager  to  recover  this  unuseable 
space.  Drives  A,  B  or  C  may  be  designated  at  the  first 
prompt  as  the  drive  to  be  used  for  scratch  files.  After 
this  prompt  is  correctly  answered,  every  thing  else  is 
performed  automatically  by  the  MCASMIS  system,  and  control 
is  returned  to  the  Database  Management  Main  Menu. 
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5.   Archiving  Records 

As  the  database  gets  too  large,  access  times  for  all 
queries  and  other  processing  increases.  Periodically,  the 
system  manager  can  select  this  option  to  archive  those  docu- 
ment and  project  records  that  are  no  longer  current.  For 
example,  all  development  item  documents  for  systems  life 
cycle  management  need  no  longer  be  retained  once  the  system 
has  been  implemented.  Similarly,  projects  that  have  been 
completed  can  be  archived  periodically.  Once  archived, 
these  records  remain  in  the  database  in  a  different  table, 
and  will  no  longer  be  retrievable  from  the  main  MCASMIS 
system.  They  will,  however,  still  be  available  to  the 
system  manager  using  the  R: base  programming  language,  or 
CLOUT. 

After  selecting  this  option,  you  are  presented  with 
another  menu  and  given  the  opportunity  to  archive  either 
documents  or  projects. 

a.  Archiving  Documents 

This  option  will  archive  all  development  item 
documents  for  a  system  that  has  been  implemented.  You  are 
prompted  for  the  system  abbreviation,  and  the  MCASMIS  system 
does  everything  else.  Upon  completion,  control  is  returned 
to  the  previous  menu  to  archive  additional  records,  or 
return  to  the  Database  Management  Main  Menu. 

b.  Archiving  Projects 

You  are  first  prompted  for  a  date.  All  projects 
that  were  completed  prior  to  this  date  will  be  archived,  and 
the  rest  will  remain  in  the  main  MCASMIS  system.  It  may  be 
desireable  to  archive  records  by  calendar  year,  by  test 
cycle,  monthly,  or  some  other  appropriate  schedule. 

While  the  archival  of  document  records  causes  no 
problems,  since  all  documents  are  input  centrally  at  HQMC, 
project  archival  should  be  performed  in  close  coordination 
with  remote  sites,    since  they  also  have  to   be  archived  at 
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those  sites  at  the  same  time.  Failure  to  do  this  will 
result  in  the  projects  returning  to  the  database  the  next 
time  data  is  transmitted  to  HQMC  from  those  remote  sites. 

When  a  project  record  is  archived,  all  associ- 
ated TTC  and  deliverable  data  is  also  archived  automati- 
cally. Only  completed  projects  may  be  archived.  Control  is 
returned  to  the  archival  menu  at  the  completion  of  this 
function. 

6.   Removing  Archived  Records  to  History 

Archiving  records  simply  moves  them  to  another  table 
within  the  MCASMIS  database  in  order  to  increase  the  respon- 
siveness of  the  MCASMIS  system.  No  space  on  the  disk  is 
recovered  by  that  action. 

As  disk  space  becomes  a  concern,  those  records  that 
have  been  archived  can  be  removed  to  a  floppy  diskette  for 
permanent  retention  using  option  5  of  the  Database 
Management  Main  Menu. 

You  may  designate  either  drive  A  or  B  for  this 
purpose.  After  inserting  an  empty,  formatted  diskette  into 
one  of  these  drives,  the  prompt  is  answered  and  the  system 
takes  over.  Upon  completion,  you  must  then  execute  either 
option  2  or  3  from  the  Database  Management  Main  Menu  before 
that  space  will  be  recovered. 

E.   SUGGESTIONS  AND  COMMENTS 

MCASMIS  is  a  prototype  system.  The  primary  purpose  of 
this  project  is  to  publish  a  functional  model  of  a  system 
for  user  perusal.  While  the  system  has  been  carefully 
checked  for  syntactical  and  logic  errors,  it  cannot  be 
assumed  to  be  completely  validated.  Any  errors  that  are 
discovered  may  be  brought  to  the  attention  of  the  author. 

Similarly,  comments  and  suggestions  concerning  additions 
and  deletions   to  this  system   are  encouraged.    It   is  only 
through  this  iterative  process  that  an  optimal  system  can  be 
developed.   Please  forward  all  such  comments  to: 
MAJ  R.  C.  Cavallaro 
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Manpower  Information  Systems  Liaison  Unit 

Code  MP I -70 

Marine  Corps  Finance  Center 

Kansas  City,  MO   64197-0001 
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